MCP Directory

How to add Stripe MCP Server (Agent Toolkit) to Claude Desktop

Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 1.9k★ · stdio · apikey · official

Claude Desktop config for Stripe MCP Server (Agent Toolkit)

npx -y @stripe/mcp --tools=all --api-key=<your-stripe-secret-key>
{
  "mcpServers": {
    "stripe-mcp-server-agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@stripe/mcp",
        "--tools=all",
        "--api-key=<your-stripe-secret-key>"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Stripe MCP Server (Agent Toolkit) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Stripe MCP Server (Agent Toolkit)'s tools appear under the 🔌 tools menu.

Before you start

  • Node.js 18+ (the local server runs via npx)
  • A Stripe account
  • A Stripe secret key — preferably a Restricted API Key (RAK) with only the permissions the agent needs, created at https://dashboard.stripe.com/apikeys
  • For the remote server (mcp.stripe.com): an MCP client that supports OAuth or bearer-token auth

What Stripe MCP Server (Agent Toolkit) can do in Claude Desktop

create_customer

Create a new customer record.

list_customers

List existing customers.

create_payment_link

Generate a shareable Stripe payment link.

create_product

Create a product in the catalog.

create_price

Create a price for a product.

create_invoice

Create an invoice; pair with create_invoice_item and finalize_invoice.

list_invoices

List invoices for review or reconciliation.

list_subscriptions

List subscriptions; update_subscription and cancel_subscription manage them.

Security

Grants live access to your Stripe account; always use a restricted API key scoped to only the needed resources rather than your full secret key. For agents, prefer the remote server's OAuth flow over embedding keys.

Stripe MCP Server (Agent Toolkit) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Stripe MCP Server (Agent Toolkit) config there under the "mcpServers" key and restart the client.

Is Stripe MCP Server (Agent Toolkit) safe to use with Claude Desktop?

Grants live access to your Stripe account; always use a restricted API key scoped to only the needed resources rather than your full secret key. For agents, prefer the remote server's OAuth flow over embedding keys.

Local server or remote (mcp.stripe.com) — which should I use?

Use the local `@stripe/mcp` server if your client only supports stdio or you want to keep keys on your machine. Use the remote server for OAuth-based, revocable, granular permissions and zero-install setup in clients like Cursor, VS Code, and Claude Code.

How do I limit what the agent can do?

Scope it with a Restricted API Key (RAK) so the server can only call the resources you grant, and/or pass `--tools=` with a specific subset of tool names instead of `--tools=all`.

Does it work with test mode?

Yes. Use a test-mode secret key (sk_test_…) and all calls hit your Stripe test data, so you can build and verify flows without moving real money.

View repo Full Stripe MCP Server (Agent Toolkit) page