Monzo MCP Server for Claude Code
Read-only Monzo banking integration for Claude Code. Query balances, view transactions, check pots, and analyze spending — all through natural conversation.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Read-only Monzo banking integration for Claude Code. Query balances, view transactions, check pots, and analyze spending — all through natural conversation.
Read-only Monzo banking MCP server for Claude Code — balances, transactions, pots, spending analysis
| Tool | Description |
|---|
monzo_is_authenticated | Verify authentication status (live ping) |
monzo_complete_auth | Complete OAuth when loopback fails (WSL/Docker fallback) |
monzo_list_accounts | List all accounts (current, joint, flex) |
monzo_get_balance | Current balance and today's spending |
monzo_list_transactions | Transaction history with merchant details |
monzo_get_transaction | Full detail on a single transaction |
monzo_list_pots | All active (non-deleted) pots with balances and goals |
monzo_spending_summary | Aggregated spending by category and top 10 merchants |
http://localhost:3118/callbackWhy do I need my own OAuth client? Monzo restricts API access to personal use — there's no public app model. You create your own client at developers.monzo.com and only your credentials touch this server.
Go to developers.monzo.com and create a Confidential client.
http://localhost:3118/callbackGives you the MCP server plus domain knowledge skills, auth hooks, and auto-updates.
In a Claude Code session, run:
/plugin marketplace add tcoretech/monzo-mcp
/plugin install monzo@tcoretech-monzo-mcp
/reload-plugins
/plugin enable monzo
Then "Configure Options" to set MONZO_CLIENT_ID and MONZO_CLIENT_SECRET (stored in the system keychain).
uvx (no install needed):
claude mcp add monzo \
-e MONZO_CLIENT_ID=your_client_id \
-e MONZO_CLIENT_SECRET=your_client_secret \
-- uvx --from monzo-mcp monzo-mcp
pip install:
pip install monzo-mcp
claude mcp add monzo \
-e MONZO_CLIENT_ID=your_client_id \
-e MONZO_CLIENT_SECRET=your_client_secret \
-- monzo-mcp
From source:
git clone https://github.com/tcoretech/monzo-mcp.git
cd monzo-mcp
pip install -e .
claude mcp add monzo \
-e MONZO_CLIENT_ID=your_client_id \
-e MONZO_CLIENT_SECRET=your_client_secret \
-- python3 mcp-server/server.py
For Claude Desktop, Cursor, or any other MCP-compatible client, add this to your configuration:
{
"mcpServers": {
"monzo": {
"command": "uvx",
"args": ["--from", "monzo-mcp", "monzo-mcp"],
"env": {
"MONZO_CLIENT_ID": "YOUR_CLIENT_ID",
"MONZO_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
}
}
}
}
This server implements a Seamless Loopback Flow. You don't need to run a separate setup command.
Note: Tokens are stored in the system keychain when available, with a plaintext fallback at
~/.monzo-mcp/tokens.json(0600 permissions). Existing plaintext tokens are automatically migrated to the keychain. Access tokens are refreshed automatically.
To force re-authentication, clear the keychain entry or delete the fallback file.
Once connected, ask Claude things like:
monzo-mcp/
├── .claude-plugin/ # Plugin metadata
│ ├── plugin.json
│ ├── marketplace.json
│ └── hooks/
│ ├── hooks.json # Session-start auth check hook
│ └── check-monzo-auth.sh
├── mcp-server/ # MCP server (Python)
│ ├── server.py # FastMCP entry point (stdio)
│ ├── tools.py # 8 tool definitions (7 banking + 1 auth helper)
│ ├── monzo_client.py # Async API client with retry
│ ├── auth.py # OAuth token management, loopback listener, auto-refresh
│ └── .env.example
├── skills/monzo/
│ └── SKILL.md # Domain knowledge for Claude
├── pyproject.toml # Python packaging (pip/uvx)
├── LICENSE
└── README.md
Credential flow:
User provides Server handles internally
┌──────────────────┐ ┌──────────────────────────┐
│ MONZO_CLIENT_ID │──env──▶ │ OAuth browser flow │
│ MONZO_CLIENT_SECRET│ │ Token exchange │
└──────────────────┘ │ Token refresh │
│ Account auto-detection │
│ ~/.monzo-mcp/tokens.json │
└──────────────────────────┘
Security:
userConfig prompts at enable time, stores securely in system keychain~/.monzo-mcp/config.json, interactive setup via SessionStart hookdecline_reason in list_transactions outputmonzo_complete_auth tool for WSL/Docker callback fallbackMIT
Read-only Monzo banking MCP server for Claude Code — balances, transactions, pots, spending analysis
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Monzo 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 Read-only Monzo banking MCP server for Claude Code — balances, transactions, pots, spending analysis