A Model Context Protocol (MCP) server implementation that integrates with Stripe for handling payments, customers, and refunds. This server provides a structured API to manage financial transactions securely.
The server provides audit logging of all Stripe operations:
The server implements Stripe API operations, including:
To install Stripe Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @atharvagupta2003/mcp-stripe --client claude
python -m venv venv
source venv/bin/activate # On macOS/Linux
venv\Scripts\activate # On Windows
pip install -e .
Set up the environment variables in a .env file:
STRIPE_API_KEY=your_stripe_secret_key
Add the server configuration to your Claude Desktop config:
Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json
MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"stripe": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/src",
"run",
"server.py"
]
}
}
}
uv run src/server.py
{
"tool": "customer_create",
"arguments": {
"email": "[email protected]",
"name": "John Doe"
}
}
{
"tool": "customer_retrieve",
"arguments": {
"customer_id": "cus_123456"
}
}
{
"tool": "payment_intent_create",
"arguments": {
"amount": 5000,
"currency": "usd",
"customer": "cus_123456"
}
}
{
"tool": "refund_create",
"arguments": {
"charge_id": "ch_abc123"
}
}
The server provides clear error messages for common scenarios:
Run the MCP Inspector for interactive testing:
npx @modelcontextprotocol/inspector uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/src run server.py
uv compile pyproject.toml
uv build
We welcome contributions! Please see our Contributing Guidelines{:target=“_blank”} for details.
This project is licensed under the MIT License - see the LICENSE{:target=“_blank”} file for details.
