io.github.friendlygeorge/stripe-mcp-server
MCP server for Stripe API — customers, charges, payments, subscriptions, products, and invoices
Open source Open in the app JSON README (API)
About
MCP server for Stripe API — customers, charges, payments, subscriptions, products, and invoices
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- friendlygeorge
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-06-06T13:06:17Z
- Repository state
- arquivado
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:48
- Updated
- 2026-08-29 03:02:48
- Origin id
io.github.friendlygeorge/stripe-mcp-server
README
# 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`:
```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:
```json
{
"mcpServers": {
"stripe": {
"command": "npx",
"args": ["-y", "stripe-mcp-server"],
"env": {
"STRIPE_API_KEY": "sk_test_your_key_here"
}
}
}
}
```
### Manual
```bash
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
```json
{ "tool": "get_balance", "arguments": {} }
```
### Create a customer
```json
{
"tool": "create_customer",
"arguments": {
"email": "customer@example.com",
"name": "Jane Doe"
}
}
```
### Create a payment intent
```json
{
"tool": "create_payment_intent",
"arguments": {
"amount": 2000,
"currency": "usd",
"customer": "cus_abc123",
"description": "Order #1234"
}
}
```
### Create a subscription
```json
{
"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
```bash
git clone https://github.com/friendlygeorge/stripe-mcp-server.git
cd stripe-mcp-server
npm install
npm run build
npm start
```
## License
MIT