Monarch Money MCP

🚀 Monarch Money MCP Server

このサーバーは、Monarch Moneyの財務データと操作にアクセスできるMCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

このサーバーを利用することで、Monarch Moneyの財務データに簡単にアクセスできます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• アカウント管理：アカウント情報の一覧表示と取得
• 取引操作：日付範囲、アカウント、カテゴリでフィルタリングして取引を取得
• 予算分析：予算データと支出の洞察にアクセス
• カテゴリ管理：取引カテゴリの一覧表示と管理
• 目標追跡：財務目標と進捗状況にアクセス
• 純資産追跡：経時的な純資産のスナップショットを取得

📦 インストール

1. このMCPサーバーをクローンまたはダウンロードします。
2. 依存関係をインストールします。

   cd /path/to/monarch-money-mcp
   uv sync
   

📚 ドキュメント

設定

サーバーを.mcp.json設定ファイルに追加します。

{
  "mcpServers": {
    "monarch-money": {
      "command": "/path/to/uv",
      "args": [
        "--directory", 
        "/path/to/monarch-money-mcp",
        "run",
        "python",
        "server.py"
      ],
      "env": {
        "MONARCH_EMAIL": "your-email@example.com",
        "MONARCH_PASSWORD": "your-password",
        "MONARCH_MFA_SECRET": "your-mfa-secret-key"
      }
    }
  }
}

⚠️ 重要提示

• /path/to/uvをuv実行ファイルの完全パスに置き換えてください（which uvで確認できます）。
• /path/to/monarch-money-mcpをこのサーバーディレクトリの絶対パスに置き換えてください。
• 相対パスではなく、絶対パスを使用してください。

MFAシークレットの取得方法

1. Monarch Moneyの設定にアクセスし、2FAを有効にします。
2. QRコードが表示されたら、「スキャンできない場合」または「手動で入力」オプションを探します。
3. シークレットキー（T5SPVJIBRNPNNINFSH5W7RFVF2XYADYXのような文字列）をコピーします。
4. これをMONARCH_MFA_SECRETとして使用します。

利用可能なツール

get_accounts

すべてのアカウントとその残高および詳細を一覧表示します。

get_transactions

オプションでフィルタリングして取引を取得します。

• start_date：この日付以降の取引をフィルタリング（YYYY-MM-DD）
• end_date：この日付以前の取引をフィルタリング（YYYY-MM-DD）
• account_ids：フィルタリングするアカウントIDのリスト
• category_ids：フィルタリングするカテゴリIDのリスト
• limit：返す取引の最大数

get_categories

すべての取引カテゴリを一覧表示します。

get_budgets

予算情報と支出分析を取得します。

get_goals

財務目標とその進捗状況を一覧表示します。

get_cashflow

収入と支出分析のためのキャッシュフローデータを取得します。

get_investments

投資アカウントの詳細とパフォーマンスを取得します。

get_net_worth

経時的な純資産のスナップショットを取得します。

💻 使用例

基本的なアカウント情報

get_accountsツールを使用して、すべてのアカウントと現在の残高を確認します。

取引分析

get_transactionsを使用して、2024年1月のすべての取引を取得します。start_dateを "2024-01-01"、end_dateを "2024-01-31" とします。

予算追跡

get_budgetsツールを使用して、現在の予算状況を表示します。

セッション管理

サーバーは自動的に認証セッションを管理します。

• セッションは.mmディレクトリにキャッシュされ、後続のログインを高速化します。
• セッションキャッシュは自動的に作成および管理されます。
• 必要に応じて、.mcp.jsonのenvセクションでMONARCH_FORCE_LOGIN=trueを設定して、新しいログインを強制します。

トラブルシューティング

MFAの問題

• MFAシークレットが正しく、適切な形式であることを確認してください。
• .mcp.jsonのenvセクションでMONARCH_FORCE_LOGIN=trueを設定してみてください。
• システム時刻が正確であることを確認してください（TOTPに必要です）。

接続の問題

• .mcp.jsonでメールアドレスとパスワードが正しいことを確認してください。
• インターネット接続を確認してください。
• サーバーを直接実行して詳細なエラーメッセージを確認してみてください。

  uv run server.py
  

セッションの問題

• .mmディレクトリを削除して、キャッシュされたセッションをクリアします。
• 一時的に.mcp.jsonのenvセクションでMONARCH_FORCE_LOGIN=trueを設定します。

🔧 技術詳細

MCPサーバー

• 作者: Taurus Colvin (@colvint)
• 説明: Monarch Money用のMCP（Model Context Protocol）サーバーラッパー

MonarchMoney Pythonライブラリ

• 作者: hammem (@hammem)
• リポジトリ: https://github.com/hammem/monarchmoney
• ライセンス: MIT License
• 説明: Monarch MoneyにAPIアクセスを提供する基盤となるPythonライブラリ

このMCPサーバーは、monarchmoney Pythonライブラリをラップして、Model Context Protocolを通じてAIアシスタントとのシームレスな統合を提供します。

セキュリティに関する注意事項

• .mcp.jsonファイルで資格情報を安全に保管してください。
• MFAシークレットはアカウントへの完全なアクセスを提供するため、パスワードと同じように扱ってください。
• .mmディレクトリのセッションファイルには認証トークンが含まれているため、安全に保管してください。
• .mcp.jsonファイルには機密性の高い資格情報が含まれているため、アクセスを制限することを検討してください。