Copilot Money MCPサーバー

ローカルのCopilot Moneyデータを使用して、AIで個人の財務状況を照会・管理する

免責事項

これは独立したコミュニティ主導のプロジェクトであり、Copilot Moneyやその親会社とは一切関係がなく、承認や提携も受けていません。 このツールは、ローカルにキャッシュされたデータに対してAIを活用したクエリを実行できるようにするために、独立した開発者によって作成されました。「Copilot Money」は、それぞれの所有者の商標です。

概要

AIアシスタントがCopilot Moneyの個人財務データにアクセスできるようにするMCPサーバーです。Mac上のローカルにキャッシュされたFirestoreデータベース（LevelDB + Protocol Buffers）から読み取ります。読み取りは100%ローカルで行われ、ネットワークリクエストは一切発生しません。 オプションの書き込みモード（--writeで有効化）では、リクエストされた変更をCopilot Moneyアプリ自体が使用しているものと同じFirebase/Firestoreバックエンドに直接送信します。これは自身の認証情報を使用して行われ、サードパーティのサービスを経由することはありません。

支出、投資、予算、目標など、35種類のツールが利用可能です：

• 17種類の読み取りツール — 取引、口座、保有資産、残高、カテゴリ、定期的な支払い、予算、目標、投資パフォーマンスなどを照会

• 18種類の書き込みツール（オプトイン） — 取引の変更の統合、タグの管理、予算の作成、定期的な項目の更新、財務の整理

デフォルトでは読み取り専用です。 書き込みツールを使用するには、サーバーを--writeオプション付きで明示的に起動する必要があります。

プライバシー第一

私たちは、このプロジェクトが運営するサーバーにデータを収集、保存、送信することは一切ありません（そのようなサーバー自体が存在しません）。詳細はプライバシーポリシーをご覧ください。

• 分析、テレメトリ、追跡は一切行いません

• 読み取りは完全にローカルで行われ、ネットワークリクエストはゼロです

• デフォルトでは読み取り専用（--writeを渡さない限り書き込みツールは無効）

• オプトインの書き込みモードでは、リクエストは自身の認証情報を使用して、自身のマシンからCopilot MoneyのFirebase/Firestoreバックエンドへ直接送信されます。サードパーティのサービスは一切介在しません

• オープンソース — コードを自身で検証可能です

クイックスタート

前提条件

• Node.js 18+ (Claude Desktopに同梱されています)

• Copilot Money (macOS App Store版)

• Claude Desktop、Cursor、またはMCP互換クライアント

Claude Desktopでのインストール

1. Releasesから最新の.mcpbバンドルをダウンロードします

2. .mcpbファイルをダブルクリックしてClaude Desktopにインストールします

3. Claude Desktopを再起動します

4. 財務に関する質問を始めましょう！

npmでのインストール

npm install -g copilot-money-mcp

次に、Claude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Cursorでのインストール

1. パッケージをグローバルにインストールします：

npm install -g copilot-money-mcp

2. Cursorの設定（Cmd + ,）を開き、Features > MCP Serversを選択します

3. サーバー設定を追加します：

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

できること

支出分析

「先月、外食にいくら使った？」

「過去30日間のAmazonでの購入をすべて表示して」

「今年の上位5つの支出カテゴリは何？」

get_transactions、get_categoriesを使用し、日付範囲、テキスト検索、カテゴリフィルタを活用します。

口座概要

「全口座の純資産はいくら？」

「過去6ヶ月間の当座預金口座の残高を月次で表示して」

「注意が必要な銀行接続はどれ？」

get_accounts、get_balance_history、get_connection_statusを使用します。

投資ポートフォリオ

「現在の保有資産と合計リターンは？」

「過去1年間のAAPLの価格履歴を表示して」

「今四半期の時間加重収益率は？」

get_holdings、get_investment_prices、get_securities、get_investment_performance、get_twr_returnsを使用します。

予算と目標

「今月の予算は順調？」

「緊急資金の進捗はどう？」

「過去6ヶ月間の目標履歴を表示して」

get_budgets、get_goals、get_goal_historyを使用します。

サブスクリプションと定期的な支払い

「どんなサブスクリプションを支払っている？」

「月々の定期的な支払いにいくら使っている？」

get_recurring_transactionsを使用します。

財務の整理（書き込みモード）

「Uberの取引をすべて『交通費』カテゴリに分類して」

「休暇の支出に#vacationタグを付けて」

「月額500ドルの外食予算を作成して」

「Netflixを月次の定期的な支払いに設定して」

update_transaction、create_budget、update_recurringなどの書き込みツールを使用します。--writeフラグが必要です。

利用可能なツール

読み取りツール (17)

書き込みツール (18) — --writeフラグが必要

書き込みモード

デフォルトでは、サーバーは読み取り専用モードで起動します。書き込みツールを有効にするには、--writeフラグを付けてサーバーを起動してください：

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp",
      "args": ["--write"]
    }
  }
}

書き込みツールは、Copilot Moneyアプリが使用しているものと同じFirebase/Firestoreバックエンドに認証済みリクエストを直接送信することで、Copilot Moneyデータを変更します。そのため、変更は即座にアカウントに反映されます。書き込みは、ローカルのCopilot Moneyセッションから抽出されたFirebaseリフレッシュトークンを使用して認証されます。認証リクエスト以外で認証情報がマシンから外部へ送信されることはありません。サードパーティのサービスは一切関与しません。詳細はPRIVACY.mdをご覧ください。

設定

キャッシュTTL

サーバーはデータをメモリ内に5分間キャッシュします。環境変数で設定可能です：

# Set cache TTL to 10 minutes
COPILOT_CACHE_TTL_MINUTES=10 copilot-money-mcp

# Disable caching (always reload from disk)
COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp

refresh_databaseツールを使用して手動で更新することも可能です。

デコードタイムアウト

大規模なデータベース（500MB以上）の場合、デコードタイムアウト（デフォルト：90秒）を増やしてください：

# Via environment variable
DECODE_TIMEOUT_MS=600000 copilot-money-mcp

# Via CLI flag
copilot-money-mcp --timeout 600000

1GBを超えるデータベースの場合は、Node.jsのメモリも増やしてください：

{
  "mcpServers": {
    "copilot-money": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096",
        "/path/to/copilot-money-mcp/dist/cli.js",
        "--timeout", "600000"
      ]
    }
  }
}

サポートされている日付期間

periodパラメータは以下のショートカットをサポートしています：

this_month last_month last_7_days last_30_days last_90_days ytd this_year last_year

既知の制限事項

ローカルキャッシュへの依存

このサーバーはクラウドではなく、Copilot MoneyのローカルFirestoreキャッシュから読み取ります。Firestoreのオフライン永続化機能は、アプリが取得したすべてのドキュメントをキャッシュするため、ローカルデータベースには通常、アプリで閲覧したすべての取引、口座、予算、目標などのデータが含まれています。デフォルトのFirestoreキャッシュサイズは100MB（数万件の取引に十分）であり、古いドキュメントは制限を超えた場合にのみLRUガベージコレクションによって削除されます。

キャッシュされるデータを最大化するには： Copilot Moneyアプリを開き、データ（取引履歴、口座、予算）を閲覧して、それらが取得されローカルにキャッシュされるようにしてください。

トラブルシューティング

データベースが見つからない

「Database not available」と表示される場合：

1. Copilot Moneyがインストールされており、データが同期されていることを確認してください

2. データベースの場所を確認してください：~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/__FIRAPP_DEFAULT/copilot-production-22904/main

3. ディレクトリ内に.ldbファイルが存在することを確認してください

4. カスタムパスを指定してください：copilot-money-mcp --db-path /path/to/database

デコードワーカーのタイムアウト

「Decode worker timed out」と表示される場合：

1. タイムアウトを増やしてください：copilot-money-mcp --timeout 300000 (5分)

2. 1GB以上のデータベースの場合は、Node.jsのメモリも増やしてください：node --max-old-space-size=4096 dist/cli.js --timeout 300000

取引が見つからない

• Copilot Moneyアプリを開き、同期を待ってください

• データベース構造が変更されている可能性があります — Issueを作成してください

貢献

開発環境のセットアップ、アーキテクチャ、新しいツールの追加方法についてはCONTRIBUTING.mdをご覧ください。

ライセンス

MITライセンス - 詳細はLICENSEをご覧ください。

謝辞

• AnthropicによるMCP SDKを使用

• Zodによるデータ検証

• Bunで開発