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

• developers.monzo.com にOAuthクライアントが登録されたMonzoアカウント

インストール

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 に設定します

• クライアントID と クライアントシークレット を控えておきます

2. 認証

monzo-mcp auth

これにより、Monzo OAuth用のブラウザが開きます。承認後、5分以内に Monzoアプリ でログインを承認すると、完全な取引履歴（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）により、取引履歴へのアクセスには制限があります：

• アプリ承認から5分以内: 最大約11ヶ月分の履歴

• 期間終了後: 直近90日間のみ

ローカルのSQLiteキャッシュは同期されたすべての取引を永続的に保持するため、monzo-mcp auth の直後に monzo_sync を実行してください。

セキュリティ

• 書き込みツールなし - 送金、ポット間の資金移動、取引の変更はできません

• Monzo API自体 も外部口座への送金はできません

• トークンは config/ ディレクトリ（gitignored）にJSONファイルとして保存されます

• すべてのAPI呼び出しは、ベアラートークン認証を使用したGETリクエストです

貢献

開発環境のセットアップ、テストワークフロー、プリコミットフックについては CONTRIBUTING.md を参照してください。変更履歴は CHANGELOG.md で管理されています。

ライセンス

GPL-3.0-or-later。 LICENSE を参照してください。