Skip to content
/chatgpt-appsOfficial

Build and scaffold ChatGPT apps using the OpenAI Apps SDK with MCP server integration.

AIOpenAIMCPApps· 2 min read

Quick import: Download the .md file and save it to .claude/commands/ (Claude Code), .cursorrules (Cursor), or paste as a system prompt in ChatGPT, Gemini, or any LLM API.

#What it does

The chatgpt-apps skill helps you build and scaffold ChatGPT apps. It classifies your app into an archetype (tool-only, vanilla-widget, react-widget, interactive-decoupled, or submission-ready), fetches current OpenAI Apps SDK docs, scaffolds MCP servers and widget UIs, and validates the result against a minimum working repo contract.

#How to use

bash
$chatgpt-apps

Preferred prompt patterns:

Use $chatgpt-apps with $openai-docs to scaffold a ChatGPT app for <use case> with a <TS/Python> MCP server and <React/vanilla> widget.

Use $chatgpt-apps to adapt the closest official Apps SDK example into a ChatGPT app for <use case>.

#Workflow

  1. Classify the app archetype -- Choose from tool-only, vanilla-widget, react-widget, interactive-decoupled, or submission-ready
  2. Plan tools before code -- Define the tool surface area from user intents with clear descriptions and annotations
  3. Choose architecture -- Minimal demo pattern for prototypes, decoupled data/render pattern for production
  4. Start from upstream examples -- Prefer official OpenAI examples, then ext-apps examples, then local scaffold
  5. Scaffold MCP server -- Register widget resources with proper MIME types, tools with schemas
  6. Scaffold widget UI -- Use MCP Apps bridge first, add window.openai APIs for ChatGPT-specific UX
  7. Add security metadata -- CSP with exact connectDomains, resourceDomains, and _meta.ui.domain
  8. Validate -- Run against the minimum working repo contract
  9. Test in ChatGPT Developer Mode -- Expose via HTTPS tunnel, connect from ChatGPT settings

#Dependencies

  • OpenAI Developer Docs MCP server (https://developers.openai.com/mcp)
  • Node.js or Python for MCP server
  • @modelcontextprotocol/ext-apps package (optional fallback scaffold)

#App archetypes

| Archetype | When to use | |-----------|-------------| | tool-only | No UI needed, just MCP tools | | vanilla-widget | Simple HTML widget, no framework | | react-widget | React-based interactive widget | | interactive-decoupled | Complex stateful apps (games, dashboards) | | submission-ready | Public directory listing with full compliance |

This skill is from the OpenAI Skills Catalog.

OpenAI·
View all skills