shadcn/ui components in ChatGPT
Add the server at chatgpt.com/plugins (opens in a new tab), then call it with @ in a chat: ChatGPT can plan a page from blocks and give you the install for your framework. It's part of shadcn.io Pro.
- Kind
- App
- Goes in
Settings → Apps- Connects
- Over HTTP
- Team config
- No
- Its docs
- ChatGPT MCP (opens in a new tab)
Add it at chatgpt.com/plugins
You add the server once on chatgpt.com, where it becomes a personal plugin you install and call with @. Signed in with Pro, the name and URL beside these steps are already yours.
Copy the name and URL
The box beside these steps holds both. The URL ends in
?token=, your key, because ChatGPT's custom servers have no field for a header. No token yet? Create one on your account.Add a custom MCP server
At chatgpt.com/plugins (opens in a new tab) (Customize → Plugins in the sidebar), select the plus button, then Add custom MCP server. Name it
shadcnioand paste the URL as the Server URL.Choose No authentication
The token in the URL is the key, so set Authentication to No authentication. Read the risk warning, select I understand and want to continue, then Create as a plugin: ChatGPT lists the 22 tools it found.
Install the plugin
Open the Personal tab, open
shadcnioand select the plus button. A custom server stays out of your chats until its plugin is installed.Call it with @
In a new chat, in Chat or Work, type
@, pickshadcnioand ask for what you need.
How it reads, with YOUR_TOKEN where your token goes:
Name: shadcnio URL: https://www.shadcn.io/api/mcp?token=YOUR_TOKEN
ChatGPT saves the URL, token included, with the plugin in your account; nothing lands on your computer. If the URL leaks, regenerate your token and add the server again.
| Where you ask | What ChatGPT does with the install |
|---|---|
| Chat, on the web, desktop or mobile | Hands you the npx shadcn add command, or every file from get_install_plan for Vue, Svelte and Solid |
| Work, run locally in the desktop app | Can run the command in the folder you opened, within your permission mode |
| Codex, in the desktop app | Reads its own list, Settings → MCP servers, shared with Codex CLI: set it up there |
Make sure ChatGPT can reach it
Your plugins live at chatgpt.com/plugins (opens in a new tab). A working shadcnio is installed there, lists its tools, and appears when you type @ in a chat.
- Find
shadcnioin the Installed row at chatgpt.com/plugins. - Open it: its details list the 22 tools ChatGPT discovered, each with its own switch.
- Start a new chat, type
@, pickshadcnioand send the prompt below. - ChatGPT calls
whoami. Expand the call: the JSON holds your email, your plan and the calls left this minute.
Three chats with the shadcn MCP
Three requests ChatGPT users make, from a pricing plan in Chat to an orders table built in a local folder with Work. Turn the MCP off to see the same request answered from memory.
- shadcn.io MCP connected · 22 tools
MCP call: plan_page({ brief: "pricing page for an invoicing app with a monthly and yearly switch", kind: "marketing" })Returns: Pricing, comparison, FAQ and a call to action, two alternatives eachMCP call: get_block({ names: ["pricing-billing-toggle", "pricing-comparison-table", "faq-saas-billing", "cta-centered-light-tier-selector"], include: ["install", "preview"] })Returns: One npx shadcn add for all four, and a preview link eachAgent step: Wrote the copy for each sectionReturns: Your plan names, prices and questions in place of the samples
In your project
Pricing page
- Four sections in the order buyers read them
- One command to run at the project's root
1 prompt → 2 MCP calls
Requests to paste after @shadcnio
Type @, pick shadcnio, then paste one. Each asks for something ChatGPT gets wrong from memory alone.
Working with it in ChatGPT
What changes in ChatGPT: plugins and @ mentions, approvals, projects, and where the install runs.
Pick it with @ first
ChatGPT can also reach for web search and your other plugins. Typing
@and pickingshadcniobefore the request settles which tools to use, and OpenAI's own advice is to add a line ruling out the rest when it strays.@shadcnio Add a toast after the profile form saves. Use only shadcnio, not web search.No approval prompts
ChatGPT asks you to confirm write actions, and treats any tool without
readOnlyHintas one. All 22 shadcnio tools carry that hint, since they only read the registry, so calls go through without a confirmation step.Open a call to check it
Expand any tool call in a reply to see the full JSON ChatGPT sent and got back. Check the
frameworkandbaseit passed, and copy install commands from there rather than from the prose.Keep your stack in a project
Chat can't see your repo. Make a ChatGPT project for the app, put the stack in its instructions and upload
package.jsonandcomponents.jsonto its sources: every chat in the project starts from them.Stack: Next.js, React on Radix, pnpm. For UI, call shadcnio before writing a component, and give me its install command exactly as returned.
Let Work run the install
In Chat, ChatGPT hands you the
npx shadcn addcommand or the files to save. In the desktop app, Work running locally on your project's folder can run the command there, pausing whenever your permission mode asks.Refresh after server updates
ChatGPT keeps the tool list it found when you created the plugin. When the server adds tools or rewrites descriptions, open
shadcnioat chatgpt.com/plugins, select Refresh and start a new chat. The same page switches single tools off.
When the plugin misbehaves
Where ChatGPT surfaces a failure, and how to clear it. The troubleshooting guide has the rest, client by client.
- The plus button at chatgpt.com/plugins has no Add custom MCP server.
- Your plan or workspace doesn't allow custom MCP servers. In a Business, Enterprise or Edu workspace, ask an admin to check Permissions & roles; Lockdown Mode can block it too.
- Create as a plugin fails or discovers no tools.
- Paste the URL whole,
?token=included, and set Authentication to No authentication: the token is the key, and this server has no OAuth sign-in to find. - An expanded tool call shows a 401.
- The token in the URL is missing or out of date, as it is after you regenerate it. Copy the URL from this page again, add the server again with it, and uninstall the old plugin.
- Tool calls come back with a 403.
- The token is valid, but its shadcn.io account has no active Pro plan. Renew it and the plugin you already have works again, unchanged.
shadcniois missing from the@menu in a chat.- It was created but never installed. Open the Personal tab at chatgpt.com/plugins, open
shadcnio, install it, then start a new chat. - ChatGPT searches the web or writes the component from memory.
- Start the message by picking
shadcniowith@, and say to use it rather than web search. Naming the component or block you want also helps it choose the tool.
Get the MCP for ChatGPT with Pro
The MCP comes with every Pro plan, with every block and premium template, for you or your whole team. Monthly, yearly or lifetime.
4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.
- Secure checkout via Stripe
- Code lives in your repo
- Keep what you've shipped if you cancel
- License terms
Frequently asked questions
The shadcn MCP in ChatGPT: setup, limits, and the rest.
Only those that allow custom MCP servers. If Add custom MCP server is missing from the plus button at chatgpt.com/plugins, your plan or workspace doesn't allow it; in a Business, Enterprise or Edu workspace, an admin can check Permissions & roles. The shadcn.io side needs a Pro plan of its own.
Older guides turned on Developer Mode and created an app. The steps on this page follow the current flow instead: at chatgpt.com/plugins, the plus button, then Add custom MCP server, which creates a personal plugin you install.
No. Set Authentication to No authentication when you create the plugin. ChatGPT's custom servers offer OAuth or nothing, with no field for a static key, so your token rides at the end of the Server URL and this server has no sign-in page to find.
You add the server on the web. After that, an installed plugin works in Chat on the web, in the desktop app and on mobile, so @shadcnio comes along. On a phone it plans pages and answers questions; the install waits for your computer.
In Chat it can't reach your computer, so it gives you the shadcn add command to run at your project's root, or for Vue, Svelte and Solid every file with its path from get_install_plan. In the desktop app, Work running locally on your project's folder can run the command there, within the permission mode you picked.
Not in Chat: it can't read your package.json, so the tools default to React on Base UI. Name the framework, and for React the primitives (Radix, Ark UI or React Aria), or keep them in a project's instructions. In Work on a local folder, it reads package.json itself.
Make a ChatGPT project for the app, write the stack in its instructions and upload package.json and components.json to its sources. Every chat inside the project then starts from them, and you can add a line telling it to call shadcnio before writing a component.
It also has web search and your other plugins to choose from. Start the message by typing @ and picking shadcnio, say to use only it, and name the component or block you want, which helps it choose the right tool.
No. ChatGPT asks for confirmation before write actions, and every shadcnio tool is marked read-only with readOnlyHint, so they run straight away. You can still expand any call to read exactly what was sent and returned.
A pasted page is one snapshot, for one framework, and it crowds the conversation. Through the plugin, ChatGPT asks the registry for only what the request needs: a component's props on your base, a block's code, an icon's import, the install for your framework. It also reaches the 6,231 Pro blocks, which pasted docs don't include.
ChatGPT keeps the tool list it found when you created the plugin. Open shadcnio at chatgpt.com/plugins, select Refresh and start a new chat. The same page has a switch for each tool if you want some off.
In the plugin's Server URL, saved with your ChatGPT account. ChatGPT's custom servers offer OAuth or no authentication, with no field for a static key, so the token travels in the URL. Keep that URL out of chats and screenshots, and if it leaks, regenerate the token on your shadcn.io account page: the leaked one is refused from then on.
Don't: the URL inside it carries your token, so everyone you share it with would be using your access. Each teammate adds their own custom server with their own URL. A Team or Organization plan on shadcn.io gives every member Pro and a token of their own.
Only the tool calls themselves: their names and inputs, such as a component's name or a search for a date picker. The rest of your chat and your files stay with ChatGPT and on your machine, and the server only reads the registry.
A 401 means the token in the URL is missing or old, for instance after you regenerate it: add the server again with the new URL. A 403 means the token is valid but the account has no active Pro plan. A 429 means more than 600 calls a minute on one token, and it clears when the Retry-After time passes.
The custom server was created but never installed. Open the Personal tab at chatgpt.com/plugins, open shadcnio, install it with the plus button, then start a new chat.
Using another agent too?
The same URL works in every MCP client: use it beside ChatGPT, in your editor, your terminal or your chat app.
4.9 out of 5 from 150+ developers
Bring the registry into ChatGPT
One custom server, and ChatGPT draws on 6,231 blocks and 294k icons whenever you type @shadcnio. Included in Pro.
Get Pro