Stripe MCP Server

MCP Server Configuration

Copy
{
  "mcpServers": {
    "stripe": {
      "command": "npx",
      "args": ["-y", "@stripe/mcp", "--tools=all"],
      "env": {
        "STRIPE_SECRET_KEY": "<your-stripe-secret-key>"
      }
    }
  }
}

Available Tools

Tool	Description
list_customers	List customers with filters
create_customer	Create a new customer record
list_products	List products in your catalog
create_product	Create a new product
list_prices	List price configurations
create_price	Create a new price for a product
list_subscriptions	List active subscriptions
create_subscription	Create a new subscription
list_payment_intents	List payment intents with status
list_invoices	List invoices with filters
create_checkout_session	Generate a Checkout session URL
list_events	List webhook events for debugging
retrieve_balance	Check your Stripe account balance
list_refunds	List refund records
create_refund	Process a refund

Setup

1. Get your API key from https://dashboard.stripe.com/apikeys
2. Use test mode key (sk_test_...) for development
3. Replace <your-stripe-secret-key> with your key
4. Optionally limit tools: --tools=customers,products,prices

Usage Examples

Once configured, ask Claude Code:

• "List recent failed payment intents and show the error reasons"
• "Create a product with monthly and annual pricing tiers"
• "Show me all webhook events from the last hour"
• "Find customer by email and show their subscription status"
• "Generate a checkout session for the Pro plan"

Security Notes

• ALWAYS use test mode keys (sk_test_) during development
• Never commit Stripe keys to version control
• Store in .claude/settings.local.json and add to .gitignore
• The --tools=all flag enables write operations - restrict with --tools= for read-only
• Review all create/update operations before approving
• Consider using Stripe restricted keys with minimal permissions