Stripe MCP Server

A Model Context Protocol (MCP) server that connects Claude (or any MCP client) to your Stripe account. Query customers, revenue, invoices, subscriptions, disputes, and issue refunds — all via natural language.

Requirements

• Node.js 18+
• A Stripe account with a secret API key

Installation

git clone https://github.com/your-username/stripe-mcp-server.git
cd stripe-mcp-server
npm install
cp .env.example .env
# Edit .env and set STRIPE_SECRET_KEY

Running manually

STRIPE_SECRET_KEY=sk_live_... node index.js

Claude Desktop Configuration

Add the following to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "stripe": {
      "command": "node",
      "args": ["/absolute/path/to/stripe-mcp-server/index.js"],
      "env": {
        "STRIPE_SECRET_KEY": "sk_live_..."
      }
    }
  }
}

Restart Claude Desktop after editing.

Tools

Tool	Description	Parameters
list_customers	List recent Stripe customers	limit (1–100, default 10)
get_revenue	Total revenue from successful charges in a date range	from (YYYY-MM-DD), to (YYYY-MM-DD)
list_invoices	List invoices by status (open = unpaid)	status (draft | open | paid | uncollectible | void)
list_failed_payments	List recent failed charges with failure reasons	limit (1–100, default 10)
get_subscription	Get all subscriptions for a customer	customer_id (e.g., cus_...)
create_refund	Issue a full or partial refund	charge_id (e.g., ch_...), amount (cents, optional)
list_disputes	List disputes/chargebacks with evidence deadlines	limit (1–100, default 10)

Example prompts

• "List my last 20 customers"
• "How much revenue did I make in May 2025?"
• "Show me all unpaid invoices"
• "What failed payments happened recently?"
• "Get subscriptions for customer cus_ABC123"
• "Refund charge ch_XYZ for $10"
• "Are there any open disputes?"

Security

• Never commit your .env file or hardcode your secret key.
• Use a restricted key with only the permissions your use case needs.
• Use sk_test_... keys for development.

License

MIT