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