chatgpt-app-builder

Build ChatGPT apps with interactive React widgets using mcp-use and the OpenAI Apps SDK.

Updated May 9, 2026
One-click install
npx skills add https://github.com/SebastienGt/LivingMargin-Google-Deepmind-Hackathon --skill chatgpt-app-builder-sebastiengt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: chatgpt-app-builder
Source: https://github.com/SebastienGt/LivingMargin-Google-Deepmind-Hackathon/tree/main/.cursor/skills/chatgpt-app-builder
Command: npx skills add https://github.com/SebastienGt/LivingMargin-Google-Deepmind-Hackathon --skill chatgpt-app-builder-sebastiengt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building ChatGPT apps requires coordinating MCP server tools, React widget components, widget state, CSP metadata, and display modes across two consumers (the human and the LLM), and this Skill provides the structured guidance to design and implement that stack correctly. ## Core Features & Use Cases - Discovery and architecture workflow: Validate app ideas through phased discovery, then decide which flows need widgets versus tools-only, avoiding anti-patterns like lazy-loading tools or widget-state-as-tools. - Server and widget implementation: Define server.tool() handlers returning widget() responses, and build React widgets with widgetMetadata, useWidget, McpUseProvider, and callTool. - State, UI, and CSP guidance: Manage persistent versus ephemeral state, handle theme/display modes/safe areas, and configure CSP connectDomains and dual-protocol metadata. - Use Case: You want a flight-booking ChatGPT app. The Skill walks you through scoping the flow, creating a search-flights widget that returns full data upfront, and a create-checkout tool the widget calls via callTool. ## Quick Start Ask the assistant to help you design and scaffold a ChatGPT app with an interactive widget using mcp-use, starting from your app idea or spec.

Frequently Asked Questions about chatgpt-app-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a ChatGPT app with interactive widgets?▼

Scaffold a project with npx create-mcp-use-app using the mcp-apps template, define server.tool() handlers that return widget() responses, and create React widget files in resources/ exporting widgetMetadata and a default component.

When should I use a widget versus a tool in a ChatGPT app?▼

Use a widget when users browse or compare items, when visual data like maps or charts helps, or when selections benefit from a visual layout. Use a tool only when inputs are conversational and output is simple text.

How do I persist widget state across reopens in ChatGPT?▼

Use state and setState from the useWidget hook, which persist across widget reopens and are visible to the LLM. React useState is ephemeral and resets on reopen, so reserve it for hover effects and transient UI.

Why does my ChatGPT widget show undefined props on first load?▼

Widgets render before the tool finishes executing, so props are empty or partial initially. Always check isPending from useWidget and render a loading state before accessing props.

How do I configure CSP for a widget calling external APIs?▼

Add a metadata.csp object in widgetMetadata with connectDomains for API endpoints and resourceDomains for static assets. Use exact HTTPS domains rather than wildcards for security.

Is chatgpt-app-builder still maintained?▼

No, this Skill is deprecated and replaced by mcp-app-builder. The SKILL.md frontmatter directs users to install mcp-app-builder via npx skills install mcp-use/mcp-use --skill mcp-app-builder.