# monzo-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: partymola
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/partymola/monzo-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/monzo-mcp

## What it 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.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0
```

### Codex

**Platform CLI**
```bash
codex mcp add monzo-mcp -- docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "monzo-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/partymola/monzo-mcp:v0.13.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "monzo-mcp": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/partymola/monzo-mcp:v0.13.0"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add monzo-mcp docker run -i --rm ghcr.io/partymola/monzo-mcp:v0.13.0
```

## When to use it
- 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
- 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

## Similar
- [Unicred MCP](https://affpapa.org/en/nevibecode/mcp/unicred-mcp.md) — MCP server · 389 installs
- [Nubank MCP](https://affpapa.org/en/nevibecode/mcp/nubank-mcp.md) — MCP server · 350 installs
- [bank-sync](https://affpapa.org/en/nevibecode/skills/bank-sync.md) — skill · 710 installs
- [import-transactions](https://affpapa.org/en/nevibecode/skills/import-transactions.md) — skill · 532 installs
- [Banco MCP](https://affpapa.org/en/nevibecode/mcp/banco-mcp.md) — MCP server · ★ 27 repo stars
- [Sprout: AI Finance & Cash Flow](https://affpapa.org/en/nevibecode/mcp/sprout-ai-finance-cash-flow.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
