Pod to App: Claude Code
How to install the Stripe MCP server in Claude Code
By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Stripe MCP's own docs on 11 Nov 2026
The short answer
Run claude mcp add --transport http stripe https://mcp.stripe.com/, start Claude Code and type /mcp to sign in to Stripe. Stripe recommends its plugin instead, which also adds skills: claude plugin install stripe@claude-plugins-official.
claude mcp add --transport http stripe https://mcp.stripe.com/- Sign-in
- OAuth, or agent API key
- Runs on
- Stripe's hosted server
- Test safely
- Grant a sandbox
- Price
- Free to connect
Plugin or plain server
| Route | Command | What you get |
|---|---|---|
| Plugin (Stripe recommends) | claude plugin install stripe@claude-plugins-official | The MCP server plus Stripe skills, kept up to date |
| Stripe CLI | stripe agent setup | Detects your agents and runs the right install for each |
| Plain MCP server | claude mcp add --transport http stripe https://mcp.stripe.com/ | Just the tools |
Install it step by step
- Step 1: Run one of the commands above in your project folder.
- Step 2: Start Claude Code and type
/mcp. Select stripe and authenticate. - Step 3: On Stripe's consent page, choose which accounts or sandboxes Claude Code may use, and set permissions for each. Pick a sandbox to start.
- Step 4: Ask: "In my sandbox, list the last five customers and their default payment methods."
Agent API keys instead of OAuth
For unattended use, create an agent API key in the Stripe Dashboard with only the permissions it needs. Keep it in an environment variable and reference it from .mcp.json, rather than passing the key on the command line:
{
"mcpServers": {
"stripe": {
"type": "http",
"url": "https://mcp.stripe.com",
"headers": { "Authorization": "Bearer ${AGENT_API_KEY}" }
}
}
}What Claude Code can do with Stripe
- Search and read most of the Stripe API through
stripe_api_search,stripe_api_detailsandstripe_api_read, without loading every endpoint into context. - Make changes with
stripe_api_write. Risky ones, such as refunds, ask for human confirmation. - Search Stripe docs and support articles with
search_stripe_documentation, handy while you write integration code. - Plan an integration with
stripe_implementation_planner.
Stripe asks you to keep tool approval on and to be careful mixing it with other servers, because text from elsewhere could try to steer the agent into acting on your account.
If it does not work
| What you see | What to do |
|---|---|
| stripe shows "needs authentication" | Run /mcp and finish the OAuth sign-in. |
| 401 with a key | The key is not an agent key, or has expired. Create an agent API key, or switch to OAuth. |
| It cannot connect on a work laptop | Your IT team may block external MCP servers. Ask them to allow mcp.stripe.com. |
| MCP is disabled for your team | An admin can turn it on in the Dashboard under MCP and CLI access, separately for live mode and sandboxes. |
MCP Shelf take
Is Stripe MCP worth adding to Claude Code?
Stripe MCP is most useful in Claude Code while you build: the agent can check the real shape of an API object, search the docs and try a call in a sandbox before writing your integration code. The plugin is the better install, since it adds Stripe's skills too. Treat live mode with care. Grant only a sandbox at first, keep approvals on, and remember the server can move money in some setups. Used that way, it removes a lot of tab-switching between your editor and the Stripe docs.
Sophie Filer
Questions
Is Stripe MCP safe to use with a live account?
You choose which accounts and sandboxes to grant during sign-in, with separate permissions. Start with a sandbox, keep tool approval on, and add live access only when you need it.
Can I still use @stripe/mcp or the agent toolkit?
Those packages are deprecated and get no more updates. Stripe points everyone to the hosted server at mcp.stripe.com.
How do I revoke Claude Code's access to Stripe?
In the Stripe Dashboard, open your user settings, find the client under OAuth sessions, and choose Revoke access. Then run claude mcp remove stripe.
Sources: the steps on this page are written in our own words from Stripe MCP's own install docs, the README, the README. If they disagree with this page, the project's docs win; please tell us from the server page.
