monzo-mcp — Claude Code MCP server: what it does, how to install
monzo-mcp is a Claude Code MCP server that grants read-only access to Monzo bank accounts, balances, and pots. It caches transactions in SQLite and calculates category spending.
GPL-3.0 ★ 6 updated 2026-11-16
claude mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0What monzo-mcp does
The server provides seven inspection tools for the Monzo API without any money movement or write operations. It checks live balances, lists savings pots, searches records by counterparty, and builds monthly expense breakdowns.
Unlike setups with raw bearer tokens, it maintains an OAuth session with automatic refresh. Local SQLite storage preserves data beyond the 90-day SCA limit; approving access in the Monzo mobile app unlocks up to 11 months of history during the initial 5-minute window. Operation requires an OAuth client from developers.monzo.com and Python 3.13+ or Docker.
What it helps with
- check current Monzo balance and pot totals
- search cached transactions by merchant or payee name
- break down monthly spending across categories
- sync banking history into a local SQLite database
Example prompts for the agent
- Check my current balance and spend today in Monzo
- Search transactions for transfers to John Doe
- Run spending analysis for last month using monzo_spending
How to install monzo-mcp
Platform CLI
claude mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0Platform CLI
codex mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0Config file
{
"mcpServers": {
"monzo-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/partymola/monzo-mcp:v0.13.0"
]
}
}
}Config file
{
"servers": {
"monzo-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/partymola/monzo-mcp:v0.13.0"
]
}
}
}Platform CLI
gemini mcp add monzo-mcp docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about monzo-mcp
How to install monzo-mcp in Claude Code?
Run claude mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0 in your terminal.
What does monzo-mcp do?
It connects an assistant to the Monzo banking API in read-only mode. The server caches account history locally in SQLite and runs spending analytics without permitting money transfers.
What is required to run monzo-mcp?
You need a Monzo account, a registered OAuth client with redirect URI http://localhost:6600/callback, and Python 3.13+ or Docker.