OpenAI Apps SDK Examples

What it does

OpenAI Apps SDK Examples is the official showcase gallery of interactive UI widgets built with the Apps SDK and MCP. It renders rich, in-conversation components inside ChatGPT — from 3D solar system explorers and interactive maps to pizza shop carousels and shopping cart checkouts. Each widget is an MCP tool response that carries embedded HTML metadata, which the Apps SDK renders inline alongside assistant messages.

Key features

• Multiple widget demos — Pizzaz (list/carousel/map views + shop), Solar System (3D Three.js viewer), Kitchen Sink Lite (full window.openai API surface), Shopping Cart (stateful multi-turn widget), and Authenticated (OAuth-protected tools)
• Apps SDK UI library — Reusable React components (images, buttons, badges) via @openai/apps-sdk-ui
• Dual-language servers — Both Node.js and Python MCP server implementations for Pizzaz and Kitchen Sink examples
• Widget state sync — widgetSessionId keeps widgetState consistent across turns so the model and UI share the same data
• Host helper APIs — callTool, requestDisplayMode, openExternal, sendFollowUpMessage for deep ChatGPT integration

Installation

• ChatGPT: Enable developer mode, then go to Settings → Connectors and add your server URL (e.g. https://<your-server>/mcp). For local testing, tunnel with ngrok: ngrok http 8000

Supported hosts

ChatGPT (via Apps SDK Connectors)