stripe-mcp

Read-Only Stripe MCP Server

[](LICENSE)

*Account data for AI tools — balance, customers, payments, invoices, catalog — without write access.*

---

Stripe MCP is a Model Context Protocol (MCP) server that exposes read-only Stripe API data as structured tool calls. Use it from Claude Code, Claude Desktop, or any MCP client. There are no create, update, or delete tools.

---

| Tool | Description | Key parameters | |------|-------------|------------------| | stripe_get_balance | Connected account balance | — | | stripe_list_customers | List customers (paginated) | limit (1–100), starting_after (cus_...) | | stripe_get_customer | Retrieve one customer | customer_id (cus_...) | | stripe_list_payment_intents | List payment intents | limit, optional customer_id | | stripe_get_payment_intent | Retrieve one payment intent | payment_intent_id (pi_...) | | stripe_list_invoices | List invoices | limit, optional customer_id | | stripe_list_products | List products | limit, optional active | | stripe_list_prices | List prices | limit, optional product_id (prod_...) |

---

From PyPI (after first release):

pip install stripe-mcp

Or install from a git clone in editable mode:

git clone https://github.com/seayniclabs/stripe-mcp.git
cd stripe-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"

Requires Python 3.12+.

Set a Stripe secret key (test or live):

export STRIPE_SECRET_KEY=sk_test_...

Prefer a restricted API key with read-only permissions.

---

Run the server (stdio transport):

stripe-mcp

Or via module:

python -m stripe_mcp

claude mcp