# ChatGPT Apps

Builds and troubleshoots ChatGPT Apps SDK servers with MCP tools and widgets.

- Repository: https://github.com/openai/skills (28445 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add openai/skills --skill chatgpt-apps -g -a claude-code -y`
Codex: `npx skills add openai/skills --skill chatgpt-apps -g -a codex -y`
Cursor: `npx skills add openai/skills --skill chatgpt-apps -g -a cursor -y`
Gemini CLI: `npx skills add openai/skills --skill chatgpt-apps -g -a gemini-cli -y`

## Description

Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# ChatGPT Apps

## Overview

Scaffold ChatGPT Apps SDK implementations with a docs-first, example-first workflow, then generate code that follows current Apps SDK and MCP Apps bridge patterns.

Use this skill to produce:

- A primary app-archetype classification and repo-shape decision
- A tool plan (names, schemas, annotations, outputs)
- An upstream starting-point recommendation (official example, ext-apps example, or local fallback scaffold)
- An MCP server scaffold (resource registration, tool handlers, metadata)
- A widget scaffold (MCP Apps bridge first, `window.openai` compatibility/extensions second)
- A reusable Node + `@modelcontextprotocol/ext-apps` starter scaffold for low-dependency fallbacks
- A validation report against the minimum working repo contract
- Local dev and connector setup steps
- A short stakeholder summary of what the app does (when requested)

## Mandatory Docs-First Workflow

Use `$openai-docs` first whenever building or changing a ChatGPT Apps SDK app.

The rest: https://github.com/openai/skills/blob/HEAD/skills/.curated/chatgpt-apps/SKILL.md