Skip to content
MCP Shelf

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.

Terminal
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

RouteCommandWhat you get
Plugin (Stripe recommends)claude plugin install stripe@claude-plugins-officialThe MCP server plus Stripe skills, kept up to date
Stripe CLIstripe agent setupDetects your agents and runs the right install for each
Plain MCP serverclaude mcp add --transport http stripe https://mcp.stripe.com/Just the tools

Install it step by step

  1. Step 1: Run one of the commands above in your project folder.
  2. Step 2: Start Claude Code and type /mcp. Select stripe and authenticate.
  3. 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.
  4. 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:

.mcp.json
{
  "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_details and stripe_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 seeWhat to do
stripe shows "needs authentication"Run /mcp and finish the OAuth sign-in.
401 with a keyThe key is not an agent key, or has expired. Create an agent API key, or switch to OAuth.
It cannot connect on a work laptopYour IT team may block external MCP servers. Ask them to allow mcp.stripe.com.
MCP is disabled for your teamAn 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.