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