monzo-mcp

用于 Monzo 银行 API 的 MCP 服务器。通过 Claude Code 或任何 MCP 客户端，提供对账户、余额、储蓄罐、交易和消费分析的只读访问权限。

与其他使用原始持有者令牌（6 小时后过期）的 Monzo MCP 实现不同，此服务器处理完整的 OAuth 并支持自动令牌刷新。

功能

• 7 个只读工具 - 无写入操作，无法进行资金转账

• 带自动刷新的 OAuth - 令牌自动刷新，无需手动重新生成

• 本地交易缓存 - SQLite 数据库可绕过 Monzo 的 90 天 SCA 窗口限制

• 消费分析 - 分类细分、热门商户、月度对比

• 交易搜索 - 在缓存的历史记录中按商户、描述或备注进行搜索

Related MCP server: monzo-mcp

工具

前置要求

• Python 3.13+

• uv (推荐) 或 pip

• 一个 Monzo 账户，并在 developers.monzo.com 注册了 OAuth 客户端

安装

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

设置

1. 注册 Monzo OAuth 客户端

前往 developers.monzo.com 并创建一个 OAuth 客户端：

• 将重定向 URL 设置为 http://localhost:6600/callback

• 记下您的 Client ID 和 Client Secret

2. 身份验证

monzo-mcp auth

这将打开浏览器进行 Monzo OAuth 授权。授权后，请在 5 分钟内在您的 Monzo App 中批准登录，以获取完整的交易历史访问权限（Monzo 的 SCA 窗口）。

3. 在 Claude Code 中注册

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. 首次同步

在 Claude Code 中，运行 monzo_sync 以填充本地交易缓存。请在授权后立即执行此操作，以利用 SCA 窗口（最多可获取 11 个月的历史记录）。

配置

所有配置均通过环境变量（可选）进行：

凭据文件（由 monzo-mcp auth 创建）：

• config/monzo_client.json - OAuth 客户端 ID 和密钥

• config/monzo_tokens.json - 访问和刷新令牌（自动刷新）

Monzo SCA 窗口

Monzo 的强客户认证 (SCA) 限制了交易历史的访问：

• App 批准后的 5 分钟内：最多约 11 个月的历史记录

• 窗口过期后：仅限最近 90 天

本地 SQLite 缓存会永久保存所有已同步的交易，因此请在 monzo-mcp auth 后尽快运行 monzo_sync。

安全性

• 零写入工具 - 无法汇款、在储蓄罐之间转移资金或修改交易

• Monzo API 本身无法向外部账户汇款

• 令牌以 JSON 文件形式存储在 config/ 目录中（已加入 gitignore）

• 所有 API 调用均为带有 Bearer 令牌认证的 GET 请求

贡献

请参阅 CONTRIBUTING.md 了解开发设置、测试工作流程和预提交钩子。变更记录在 CHANGELOG.md 中。

许可证

GPL-3.0-or-later。请参阅 LICENSE。