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