How to Connect Stripe Remote MCP to Gemini CLI
Add Stripe's remote MCP server to Gemini CLI in about a minute.
Step-by-step
- Edit ~/.gemini/settings.jsonAdd the
mcpServersentry shown above โ Gemini CLI useshttpUrlfor Streamable HTTP endpoints andurlfor legacy SSE. - AuthorizeOn first use your client opens a Stripe OAuth consent screen โ approve it and tools become available.
- VerifyRestart
gemini, then run/mcp listinside the CLI. Verify in the browser: pastehttps://mcp.stripe.cominto remotemcp.net/inspector and run initialize + tools/list.
Troubleshooting OAuth / 401
- A
401 Unauthorizedon first connect is normal โ the endpoint is OAuth-protected; let Gemini CLI finish the browser consent flow. - If the consent window never opens, remove and re-add the server, then retry.
- Check the exact challenge at our OAuth debugger.
- Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}claude mcp add --transport http stripe https://mcp.stripe.com
Or add to .vscode/mcp.json:
{
"servers": {
"stripe": {
"type": "http",
"url": "https://mcp.stripe.com"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.stripe.com - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"stripe": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.stripe.com"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"stripe": {
"serverUrl": "https://mcp.stripe.com"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"stripe": {
"url": "https://mcp.stripe.com"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.stripe] url = "https://mcp.stripe.com"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"stripe": {
"type": "streamableHttp",
"url": "https://mcp.stripe.com"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"stripe": {
"httpUrl": "https://mcp.stripe.com"
}
}
}Tools exposed by Stripe MCP (43)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| get_stripe_account_info ~36 tok | ๐ข Read | Get details of the connected Stripe account. | โ |
| retrieve_balance ~34 tok | ๐ข Read | Retrieve the current Stripe account balance. | โ |
| search_documentation ~34 tok | ๐ข Read | Search Stripe's official documentation. | โ |
| create_customer ~30 tok | ๐ Write | Create a new Stripe customer. | โ |
| list_customers ~28 tok | ๐ข Read | List Stripe customers. | โ |
| update_customer ~32 tok | ๐ Write | Update a Stripe customer's details. | โ |
| create_product ~30 tok | ๐ Write | Create a new Stripe product. | โ |
| list_products ~28 tok | ๐ข Read | List Stripe products. | โ |
| create_price ~31 tok | ๐ Write | Create a price for a Stripe product. | โ |
| list_prices ~27 tok | ๐ข Read | List Stripe prices. | โ |
| create_payment_link ~31 tok | ๐ Write | Create a Stripe payment link. | โ |
| create_payment_intent ~36 tok | ๐ Write | Create a PaymentIntent to collect a payment. | โ |
| list_payment_intents ~29 tok | ๐ข Read | List PaymentIntents. | โ |
| create_invoice ~30 tok | ๐ Write | Create a draft Stripe invoice. | โ |
| create_invoice_item ~32 tok | ๐ Write | Add a line item to an invoice. | โ |
| finalize_invoice ~33 tok | ๐ Write | Finalize a draft invoice for payment. | โ |
| list_invoices ~28 tok | ๐ข Read | List Stripe invoices. | โ |
| list_charges ~27 tok | ๐ข Read | List Stripe charges. | โ |
| create_refund ~27 tok | ๐ด Destructive | Refund a charge. | โ |
| list_subscriptions ~30 tok | ๐ข Read | List Stripe subscriptions. | โ |
| retrieve_subscription ~32 tok | ๐ข Read | Retrieve a subscription by ID. | โ |
| update_subscription ~32 tok | ๐ Write | Update an existing subscription. | โ |
| cancel_subscription ~30 tok | ๐ด Destructive | Cancel a subscription. | โ |
| create_coupon ~28 tok | ๐ Write | Create a Stripe coupon. | โ |
| list_coupons ~27 tok | ๐ข Read | List Stripe coupons. | โ |
| create_tax_rate ~29 tok | ๐ Write | Create a Stripe tax rate. | โ |
| list_tax_rates ~28 tok | ๐ข Read | List Stripe tax rates. | โ |
| list_disputes ~27 tok | ๐ข Read | List card disputes. | โ |
| update_dispute ~33 tok | ๐ Write | Update or submit evidence for a dispute. | โ |
| create_payout ~34 tok | ๐ Write | Create a payout to a connected bank account. | โ |
| list_payouts ~27 tok | ๐ข Read | List Stripe payouts. | โ |
| create_transfer ~33 tok | ๐ Write | Create a transfer to a connected account. | โ |
| list_payment_methods ~33 tok | ๐ข Read | List payment methods for a customer. | โ |
| create_checkout_session ~33 tok | ๐ Write | Create a Stripe Checkout session. | โ |
| list_meters ~27 tok | ๐ข Read | List billing meters. | โ |
| create_billing_portal_session ~37 tok | ๐ Write | Create a customer billing portal session. | โ |
| list_checkout_sessions ~31 tok | ๐ข Read | List Checkout sessions. | โ |
| expire_checkout_session ~33 tok | ๐ Write | Expire an open Checkout session. | โ |
| create_terminal_reader ~31 tok | ๐ Write | Create a Terminal reader. | โ |
| list_terminal_readers ~30 tok | ๐ข Read | List Terminal readers. | โ |
| list_balance_transactions ~32 tok | ๐ข Read | List balance transactions. | โ |
| list_events ~27 tok | ๐ข Read | List Stripe events. | โ |
| create_credit_note ~29 tok | ๐ Write | Create a credit note. | โ |
Connect Stripe MCP to another client
Other servers for Gemini CLI
GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.
Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ connect and call tools immediately.