A Claude Code plugin for building complete ChatGPT Apps with MCP servers, React widgets, and cloud deployment.

This plugin helps you build ChatGPT Apps from concept to deployment:

1. Conceptualize - Define value proposition, use cases, and tool topology
2. Design - Create MCP tools and React widgets following best practices
3. Implement - Generate complete TypeScript code
4. Test - Validate with golden prompts and MCP Inspector
5. Deploy - Ship to Render with PostgreSQL via Supabase

# Add to your Claude Code plugins
claude plugin add chatgpt-apps-builder

# Start building a new ChatGPT App
/chatgpt-app:new

# Resume an in-progress app
/chatgpt-app:resume

Database management for your ChatGPT App:

• Create and manage tables
• Run migrations
• Test queries

claude mcp add supabase https://mcp.supabase.com/mcp

Deployment automation:

• Create web services
• Provision PostgreSQL
• Manage environment variables

claude mcp add --transport http render https://mcp.render.com/mcp --header "Authorization: Bearer $RENDER_API_KEY"

my-chatgpt-app/
├── package.json
├── tsconfig.json
├── setup.sh               # One-command setup script
├── START.sh               # Start server script
├── server/
│   ├── index.ts           # MCP server entry
│   ├── tools/             # Tool handlers
│   ├── resources/         # Widget resources
│   ├── auth/              # Authentication (optional)
│   └── db/                # Database pool (optional)
├── web/
│   ├── src/
│   │   ├── hooks.ts       # Apps SDK hooks
│   │   ├── theme.ts       # Theming utilities
│   │   └── ui/            # React components
│   └── package.json
├── supabase/              # Database migrations (optional)
│   └── migrations/
├── .env.example
├── .chatgpt-app/
│   └── state.json         # Build progress
├── Dockerfile
└── render.yaml

Generated apps include foolproof setup scripts:

One-command setup that:

• Checks prerequisites (Node.js, npm, Supabase CLI, Docker)
• Installs dependencies
• Builds web assets (widgets)
• Builds server
• Starts local Supabase (if database enabled)
• Applies database migrations
• Auto-generates .env with correct credentials

./setup.sh

Start the server in different modes:

./START.sh              # HTTP mode (for ChatGPT connector)
./START.sh --stdio      # Stdio mode (for MCP Inspector)
./START.sh --dev        # Development mode with hot reload

This plugin enforces ChatGPT Apps best practices:

• Design for conversational entry
• Create atomic, composable tools
• Use UI to enhance, not decorate
• Keep responses concise

• Display static website content
• Require complex multi-step workflows
• Duplicate ChatGPT's native features
• Include ads or upsells

/chatgpt-app:validate

Checks:

• MCP schema validity
• Tool annotations
• Widget CSP configuration
• Database migrations
• UX principles compliance

/chatgpt-app:golden-prompts

Generates:

• Direct prompts (5+ per tool)
• Indirect prompts (5+ per tool)
• Negative prompts (3+ per category)

/chatgpt-app:test

Tests:

• Tool discovery
• Tool execution
• Error handling
• Widget rendering

/chatgpt-app:deploy

This will:

1. Run validation and tests
2. Generate render.yaml and Dockerfile
3. Create PostgreSQL database
4. Deploy web service
5. Configure environment variables
6. Verify health checks
7. Provide ChatGPT connector URL

Your build progress is saved to .chatgpt-app/state.json:

{
  "appName": "my-app",
  "phase": "implementation",
  "tools": [...],
  "widgets": [...],
  "auth": { "enabled": true, "provider": "auth0" },
  "database": { "enabled": true, "provider": "supabase" },
  "validation": { "passed": true },
  "deployment": { "status": "deployed" }
}

Resume anytime with /chatgpt-app:resume.

The plugin includes templates for:

• Base: Package config, TypeScript setup, server entry
• Tools: CRUD, query, widget, external API patterns
• Widgets: List, detail, form, carousel patterns
• Auth: Auth0 and Supabase configurations
• Database: Supabase migrations and connection pool
• Deploy: Dockerfile and Render configuration

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

MIT

• ChatGPT Apps SDK Documentation
• MCP Specification
• Claude Code Plugins
• Supabase MCP
• Render MCP