Monarch Money MCPサーバー

Claude Desktopを通じてMonarch Money個人財務プラットフォームと統合するためのModel Context Protocol (MCP) サーバーです。

概要

• 設計による安全性 — ブラウザベースのログイン、トークンはOSのキーチェーンに保存（設定ファイルや環境変数には保存されません）

• デフォルトで安全 — 読み取り専用モードにより誤操作を防止。書き込みツールには明示的なオプトインが必要

• 包括的 — 口座、取引、分割、予算、キャッシュフロー、タグ、カテゴリ、クレジット履歴を網羅する37のツール

• インストールが簡単 — Claude Desktop拡張機能 (.mcpb)、uvx、または pip に対応

2つの動作モード:

サーバーはデフォルトで読み取り専用モードで起動します。書き込みツールは、明示的にオプトインするまで非表示かつブロックされます。

Related MCP server: Monarch Money MCP Server

クイックスタート

インストール

オプション 1: Claude Desktop拡張機能 (.mcpb) — Claude Desktopに推奨

Claude Desktopアプリから直接書き込みモードのオン/オフを切り替えられます。

1. Releases から最新の .mcpb をダウンロード

2. Claude Desktopで Settings > Extensions > Advanced Settings > Install Extensions を選択し、.mcpb ファイルを選択

3. Claude Desktopを再起動

書き込みツールを有効にするには: Settings > Extensions > Monarch Money MCP Server > Configure で "Enable write tools" を切り替え、「保存」をクリックします。

オプション 2: uvx (インストール不要) — エージェント (Claude CodeやCursorなど) に推奨

Claude Desktopでも動作しますが、アプリから書き込みモードを切り替えることはできません。設定ファイルで指定してください。

MCP設定ファイルに追加:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp"]
    }
  }
}

書き込みツールを有効にするには:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp", "--enable-write"]
    }
  }
}

オプション 3: pip install — ローカルインストールおよびvenvに推奨

pip install monarch-mcp

コントリビューターの方へ: リリースプロセス、バージョン体系、TestPyPIを通じたプレリリーステストについては docs/releasing.md を参照してください。

Pythonインタープリタへのフルパスを使用してMCP設定に追加:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

書き込みツールを有効にするには、args に "--enable-write" を追加します。

オプション 4: クローンとインストール — 開発に推奨

git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .

次に、開発環境のPythonインタープリタを使用してMCP設定に追加:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

書き込みツールを有効にするには、args に "--enable-write" を追加します。

認証

認証は、保存されたセッションなしでMCPサーバーが最初に起動したときに、ブラウザで自動的に行われます。

1. Claude Desktopを起動（または再起動）

2. サーバーがトークンが存在しないことを検出し、ブラウザでログインページを開きます

3. Monarch Moneyのメールアドレスとパスワードを入力

4. MFAが有効な場合は2FAコードを入力

5. 認証が完了すると、トークンがシステムキーリングに保存されます — これで準備完了です

重要な詳細:

• 認証情報はブラウザでのみ入力 — Claude Desktop経由では入力されません

• トークンはOSのキーリングに保存 — 再起動後も保持され、数週間から数ヶ月間有効です

• 期限切れセッションは自動的に再認証 — 次のツール呼び出し時にブラウザログインが再トリガーされます

• MFAを完全サポート

• フォールバック: ヘッドレス環境の場合はターミナルで python login_setup.py を実行してください

認証アーキテクチャの技術的な詳細については、docs/authentication.md を参照してください。

使用例

Show me all my financial accounts

What were my last 50 transactions?

How's my budget looking this month?

Analyze my cashflow for the last 3 months

Create a tag called "Business Expenses" in red

利用可能なツール

🙏 謝辞

@robcerda 氏の monarch-mcp-server をフォークし、vargahis が保守しています。

monarchmoneycommunity Pythonライブラリを基盤としています。

感謝:

• オリジナルのMCPサーバーを作成した @robcerda 氏

• オリジナルの monarchmoney ライブラリを作成した @hammem 氏

• コミュニティフォークを作成した @bradleyseanf 氏

ライセンス

MIT License