PlugWiki
Stripe MCP logo

Add Stripe to Claude Code

Add Stripe's hosted server or plugin to Claude Code and sign in, and Claude can look up and change your Stripe data from the terminal.

Add Stripe's hosted server with one command, or install the Stripe plugin, then sign in to Stripe from /mcp. Claude Code can then look up customers and payments, search Stripe's docs, and make changes such as refunds. Pick a sandbox on Stripe's sign-in page before you connect a live account. The plugin also adds Stripe's coding guidance, so choose it if you build on Stripe.

Good for

  • Developers building a Stripe integration who want Stripe's docs and API inside Claude Code
  • Engineers who debug payments, subscriptions and webhooks against a sandbox
  • Connect platforms running agents on connected accounts with an agent key
  • Teams moving off sk_ keys before Stripe's November 30, 2026 cutoff

Add Stripe to Claude Code

Claude Code

  1. 1

    Copy this prompt.

    Add the Stripe MCP server to Claude Code. Run this command:

claude mcp add --transport http stripe https://mcp.stripe.com/

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Stripe account; approve access in Stripe's OAuth window.

Read-only mode: There's no read-only switch. Pick read-only permissions on Stripe's sign-in page, or use an agent key with only Read access.

After claude mcp add, start Claude Code, run /mcp, pick stripe and sign in. On Stripe's page, choose a sandbox first and pick read-only if you only need lookups. The plugin adds the same server plus Stripe's coding skills; stripe agent setup installs the plugin for you. Stripe's docs page shows stripe@anthropic-plugin-directory, but that is not one of Claude Code's marketplace names; Stripe's GitHub README and Anthropic's official marketplace use stripe@claude-plugins-official, as shown here. Use the API key option only for connected accounts or unattended runs. Full secret keys (sk_) and untagged restricted keys stop working after November 30, 2026.

From the vendor's docs. Source.

Common errors and fixes

  • /mcp shows stripe as needing authentication

    Cause: claude mcp add only registers the server; sign-in happens separately.

    Fix: Start Claude Code, run /mcp, pick stripe and finish Stripe's sign-in in the browser.

    claude-code Source

  • 401 with an OAuth discovery challenge when using an API key

    Cause: From December 2026 Stripe rejects full secret keys and restricted keys without the Agent tag.

    Fix: Create an agent API key, or remove the header and sign in with OAuth from /mcp.

    claude-code Source

  • Authorization header is empty or the key is rejected from .mcp.json

    Cause: The environment variable named in ${AGENT_API_KEY} is not set in the shell that started Claude Code.

    Fix: Export the variable in your shell, then start Claude Code again from that shell.

    claude-code Source

  • Browser says authorization succeeded, but Claude Code keeps spinning and fails to connect

    Cause: One open report; the cause is not confirmed.

    Fix: Retry from /mcp; if it keeps failing, use the agent API key option instead of OAuth.

    claude-code Source

  • Live account is greyed out on Stripe's Choose an environment screen

    Cause: Stripe shows no reason. One possible cause: an admin turned off MCP access for live mode, which Stripe lets admins set apart from sandboxes.

    Fix: Ask a Stripe admin to check MCP and CLI access settings in the Dashboard, or work in a sandbox.

    claude-code Source

  • Plugin install fails: your local changes would be overwritten by checkout

    Cause: A git checkout error during plugin install, in one Windows report that Stripe could not reproduce.

    Fix: Add the server with claude mcp add instead, and install Stripe's skills separately.

    claude-code Source

  • A refund stays pending and is never created

    Cause: Refunds need human confirmation in the Stripe Dashboard first.

    Fix: Open the link Claude Code gives you, approve it within 24 hours, then ask Claude Code to retry.

    claude-code Source

  • Stripe server will not connect on a work laptop

    Cause: Managed devices or networks can block external MCP servers.

    Fix: Ask IT to allow mcp.stripe.com.

    claude-code Source

Permissions

High risk

Signed in to your live account, Claude Code can refund customers, cancel subscriptions and void invoices, and only refunds and money moves wait for your approval. Sign in to a sandbox first and keep Claude Code's approval prompt on for every Stripe write.

What it can do

Watch out for

  • Claude Code can change live Stripe data

    It can create refunds, cancel subscriptions and void invoices. Pick a sandbox when you sign in, and never choose "don't ask again" for write calls. docs.stripe.com

  • Keep agent keys out of a shared .mcp.json

    A project .mcp.json is often committed to git. Reference an environment variable for the key, as Stripe's docs show. docs.stripe.com

  • Other servers' text can steer Stripe actions

    Stripe warns about prompt injection when it runs alongside other servers. Keep Claude Code's approval prompt on for Stripe. docs.stripe.com

  • The plugin reports skill use to Stripe

    Set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1 in your environment to stop it. github.com

  • Refunds still wait for your OK

    Refunds and Treasury money moves need approval in the Stripe Dashboard, and the request expires after 24 hours. docs.stripe.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyGrant read-only permissions per environment on Stripe's OAuth consent page, or use an agent API key with Read permissions. In Claude Code, a deny rule on the write tool (mcp__stripe__stripe_api_write, or mcp__plugin_stripe_stripe__stripe_api_write for the plugin) also blocks changes.
Talks tomcp.stripe.com
Sign-in and keysOAuth: Claude Code stores the session after /mcp; revoke it under OAuth sessions in Stripe user settings. API key: read from an environment variable referenced in .mcp.json.

Works in

Stripe documents three ways to connect Claude Code. Two open reports describe Stripe sign-in that never finishes.

Tap an app to see how to set it up and any known problems.

Questions

How do I add Stripe to Claude Code?

Run the claude mcp add command in the install box, start Claude Code and type /mcp to sign in to Stripe. Or install the Stripe plugin, which adds the same server plus Stripe's coding skills.

Should I use the Stripe plugin or claude mcp add?

Use the plugin if you build on Stripe, because it adds Stripe's coding guidance and keeps it updated. Use claude mcp add if you only want to look up and change account data.

Why does Stripe not show up in Claude Code?

Run /mcp and check the stripe entry. If it needs sign-in, sign in there. If you added it in another folder, the default scope ties it to that folder, so add it again here or use --scope user.

Sign-in finished in the browser but Claude Code keeps spinning. What now?

One user reports this in an open issue, with no fix yet. Try signing in again from /mcp; if it keeps failing, use the agent API key option in the install box instead of sign-in.

Why is my live account greyed out when I sign in?

Stripe does not say why on that screen. One possible cause is that an admin turned off MCP access for live mode, which Stripe lets admins set separately from sandboxes, so ask your Stripe admin to check MCP access in the Dashboard.

Can I connect more than one Stripe account?

Yes. Stripe's sign-in page lets you grant several live accounts or sandboxes at once, each with its own permissions.

Will my sk_ secret key still work in Claude Code?

No, not after November 30, 2026. Stripe then rejects full secret keys and untagged restricted keys, so sign in with your Stripe account or create an agent API key.

How do I stop Claude Code from making changes in Stripe?

Pick read-only permissions on Stripe's sign-in page. You can also add a Claude Code deny rule for the write tool, mcp__stripe__stripe_api_write, or mcp__plugin_stripe_stripe__stripe_api_write if you use the plugin.

Why didn't my refund go through?

Refunds wait for your approval in the Stripe Dashboard. Open the link Claude Code gives you, approve it, then tell Claude Code to try again; unapproved requests expire after 24 hours.

Can Claude Code work on my Connect connected accounts?

Only with an agent API key. Stripe's sign-in does not cover connected accounts, so use a platform agent key and add the connected account's ID as a header.

Information

updated Nov 1, 2026

Stripe for AI agentsStripe MCP docsGitHubnpmOfficial MCP RegistryStripe agent plugin setupIssuesStripe privacy policyStripe support

More on this

Sources

Docs, issue trackers and discussions this page is built from.

Show all 12
  1. docs.stripe.com · docs.stripe.com
  2. docs.stripe.com · docs.stripe.com
  3. github.com · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. Plugin security: official marketplace names · code.claude.com
  7. github.com · github.com
  8. github.com · github.com
  9. github.com · github.com
  10. code.claude.com · code.claude.com
  11. code.claude.com · code.claude.com
  12. github.com · github.com

Updated Nov 1, 2026.