stripe mcp server

Stripe MCP Server

A Model Context Protocol server for the Stripe API. Provides 21 tools for managing customers, charges, payments, subscriptions, products, prices, invoices, refunds, transfers, and webhooks.

Features

• Balance — Check available and pending balances
• Customers — List, create, retrieve, update customers
• Charges — List and retrieve charges with filters
• Payment Intents — Create and list payment intents
• Products — List and create products
• Prices — List and create one-time and recurring prices
• Subscriptions — List, create, and cancel subscriptions
• Invoices — List invoices with status filters
• Refunds — Full or partial refunds with reason tracking
• Transfers — List Connect platform transfers
• Webhooks — List and create webhook endpoints

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "stripe-mcp-server"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Cursor / VS Code

Add to your MCP configuration:

{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "stripe-mcp-server"],
      "env": {
        "STRIPE_API_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Manual

npm install -g stripe-mcp-server
export STRIPE_API_KEY=sk_test_your_key_here
stripe-mcp-server

Environment Variables

Variable	Required	Description
STRIPE_API_KEY	Yes	Your Stripe secret key (sk_test_... or sk_live_...)

Usage

Get account balance

{ "tool": "get_balance", "arguments": {} }

Create a customer

{
  "tool": "create_customer",
  "arguments": {
    "email": "customer@example.com",
    "name": "Jane Doe"
  }
}

Create a payment intent

{
  "tool": "create_payment_intent",
  "arguments": {
    "amount": 2000,
    "currency": "usd",
    "customer": "cus_abc123",
    "description": "Order #1234"
  }
}

Create a subscription

{
  "tool": "create_subscription",
  "arguments": {
    "customer": "cus_abc123",
    "price": "price_xyz789"
  }
}

API Coverage

Resource	Tools
Balance	get_balance
Customers	list_customers, create_customer, retrieve_customer, update_customer
Charges	list_charges, retrieve_charge
Payment Intents	create_payment_intent, list_payment_intents
Products	list_products, create_product
Prices	list_prices, create_price
Subscriptions	list_subscriptions, create_subscription, cancel_subscription
Invoices	list_invoices
Refunds	create_refund
Transfers	list_transfers
Webhooks	list_webhook_endpoints, create_webhook_endpoint

Development

git clone https://github.com/friendlygeorge/stripe-mcp-server.git
cd stripe-mcp-server
npm install
npm run build
npm start

License

MIT