Lunchmoney MCP

🚀 Lunch Money MCP Server

Lunch Money MCP Serverは、Lunch Money API用のMCP（Model Context Protocol）サーバーです。これにより、AIアシスタントがLunch Moneyアカウントとやり取りして、取引、カテゴリ、予算などを管理することができます。

✨ 主な機能

このMCPサーバーを通じて、Lunch Moneyの以下の機能にアクセスできます。

• ユーザー：アカウント情報の取得
• カテゴリ：カテゴリの作成、読み取り、更新、削除
• 取引：取引の管理（作成、読み取り、更新、フィルタリング）
• タグ：すべてのタグの取得
• 資産：口座/資産の管理
• 予算：予算の取得と更新
• 定期取引：定期取引の取得
• Plaid口座：Plaidで接続された口座の管理
• 暗号資産：暗号資産の管理

📦 インストール

オプション1: 自動インストール（簡単）

python install.py

このスクリプトは以下のことを自動的に行います。

• ✅ パッケージの自動インストール
• ✅ Lunch Moneyのトークンの入力要求
• ✅ Claude Desktopの自動設定
• ✅ 使用可能状態への移行

オプション2: 手動インストール

pip install lunchmoney-mcp

次に、claude_desktop_config.jsonファイルに以下の設定を追加します。

{
  "mcpServers": {
    "lunchmoney": {
      "command": "lunchmoney-mcp",
      "env": {
        "LUNCHMONEY_ACCESS_TOKEN": "tu_token_aqui"
      }
    }
  }
}

以上で完了です！ 🎉 Playwright MCPと同じくらい簡単です。

アクセストークンの取得方法

1. https://my.lunchmoney.app/developersにアクセスします。
2. 新しいアクセストークンを作成します。
3. 上記の設定でそのトークンを使用します。

ソースコードからのインストール

ソースコードからインストールする場合は、以下の手順を実行します。

1. リポジトリのクローン

   git clone <repository-url>
   cd lunchmoney-mcp
   

2. インストール

   pip install -e .
   

3. Claude Desktopでの設定

   {
     "mcpServers": {
       "lunchmoney": {
         "command": "lunchmoney-mcp",
         "env": {
           "LUNCHMONEY_ACCESS_TOKEN": "tu_token_aqui"
         }
       }
     }
   }
   

設定ファイルの場所

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

💻 使用例

設定が完了したら、Claude Desktopを使用してLunch Moneyアカウントとやり取りできます。以下にいくつかの使用例を示します。

基本的な使用法

1. ユーザー情報の取得

   "Muéstrame la información de mi cuenta de Lunch Money"
   

2. すべてのカテゴリの表示

   "Lista todas mis categorías de Lunch Money"
   

3. 新しいカテゴリの作成

   "Crea una nueva categoría llamada 'Entretenimiento' en Lunch Money"
   

4. 最近の取引の表示

   "Muéstrame las transacciones del último mes"
   

5. 取引の作成

   "Añade una transacción de $50 para 'Supermercado XYZ' en la categoría 'Comida'"
   

6. 予算の表示

   "Muéstrame el resumen del presupuesto de este mes"
   

📚 詳細ドキュメント

ユーザー

• get_user：ユーザーとアカウントの情報を取得します。

カテゴリ

• get_all_categories：すべてのカテゴリを取得します。
• get_single_category：特定のカテゴリを取得します。
• create_category：新しいカテゴリを作成します。
• update_category：既存のカテゴリを更新します。
• delete_category：カテゴリを削除します。

取引

• get_all_transactions：すべての取引を取得します（フィルター付き）。
• get_single_transaction：特定の取引を取得します。
• insert_transactions：新しい取引を挿入します。
• update_transaction：既存の取引を更新します。

タグ

• get_all_tags：すべてのタグを取得します。

資産

• get_all_assets：すべての資産/口座を取得します。
• create_asset：新しい資産/口座を作成します。
• update_asset：既存の資産を更新します。

予算

• get_budget_summary：予算の概要を取得します。
• upsert_budget：予算データを作成または更新します。

定期取引

• get_recurring_items：すべての定期取引を取得します。

Plaid口座

• get_all_plaid_accounts：すべてのPlaid口座を取得します。
• trigger_plaid_fetch：Plaidとの同期を開始します。

暗号資産

• get_all_crypto：すべての暗号資産を取得します。
• update_manual_crypto：暗号資産を手動で更新します。

🔧 開発に関する情報

開発に貢献するには、以下の手順を実行します。

1. 開発用依存関係のインストール

   pip install -e ".[dev]"
   

2. テストの実行

   pytest
   

3. コードのフォーマット

   black lunchmoney_mcp/
   

⚠️ セキュリティに関する注意

• Lunch Moneyのアクセストークンを決して共有しないでください。
• トークンは.envファイルに保存し、.gitignoreに含めるようにしてください。
• MCPサーバーはローカルで実行され、外部サービスにデータを送信することはありません。

🚫 制限事項

• Lunch Money APIはパブリックベータ版であるため、仕様変更がある可能性があります。
• 一部の操作には速度制限がある場合があります。
• APIを通じて行った変更は元に戻せません。

🛠️ サポート

問題が発生した場合は、以下の手順を試してください。

1. アクセストークンが有効であることを確認します。
2. Lunch Moneyの公式ドキュメントを参照します。
3. MCPサーバーのログを確認して、特定のエラーを探します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🔗 関連リンク

• Lunch Money
• Lunch Money APIドキュメント
• Model Context Protocol
• Claude Desktop