Lunchmoney MCP Server

🚀 ランチマネー MCP サーバー

このツールは、Claudeやその他のAIアシスタントを通じて、Lunchmoney（https://lunchmoney.app）の取引や予算と対話できるモデルコンテキストプロトコル（MCP）サーバーです。

これは何ですか？

このツールを使用すると、Lunchmoneyの財務データをClaude AIに接続できます。これにより、自然な会話で支出に関する質問をしたり、予算を分析したり、財務に関する洞察を得ることができます。

✨ 主な機能

このサーバーは、以下の4つの主要な機能を提供します。

1. 最近の取引を取得：過去N日間の最近の取引を確認します。
2. 取引を検索：支払い者名または備考のキーワードで取引を検索します。
3. カテゴリ別の支出：特定のカテゴリの支出状況を分析します。
4. 予算の概要：支出、残高、繰り返し項目を含む詳細な予算情報を取得します。

🔒 プライバシーとデータ処理

⚠️ 重要な注意事項

MCPは、ClaudeがあなたのLunchmoneyデータとやり取りする構造化された方法を提供し、プライバシーの境界を維持します。以下の点に注意してください。

• Claude（ホスト）は、あなたのローカルのMCPサーバーに接続するクライアントを作成します。
• あなたのLunchmoney APIトークンは、あなたのローカルマシンに保持されます。
• MCPサーバーはローカルで実行され、LunchmoneyのAPIからデータを取得します。
• あなたのLunchmoneyデータにアクセスするたびに、承認を求めるメッセージが表示されます。
• 財務に関する質問をすると、ClaudeはMCPサーバーから特定の情報を要求します。
• MCPサーバーはあなたの要求をローカルで処理し、関連する結果のみを返します。
• Claudeはあなたの完全な財務データやAPIトークンに直接アクセスすることはありません。
• 要求された特定の情報（取引の要約や予算の状態など）のみがClaudeと共有されます。
• Anthropicのデータ保持ポリシーが、会話の一部としてこれらの要約結果に適用されます。
• 各サーバー接続は分離され、明確なセキュリティ境界が維持されます。

MCPに関する詳細情報は、こちらのドキュメントで確認できます：https://modelcontextprotocol.io/introduction

📦 インストール

公式のClaudeドキュメントも参照してください：https://modelcontextprotocol.io/quickstart/user

npxを使用する

Node.jsは、コンピューター上（Webブラウザではなく）でJavaScriptコードを実行できるソフトウェアプラットフォームです。

Node.jsをインストールするには：

• Windows/Mac：公式Node.jsサイトからインストーラーをダウンロードして実行します。
• Homebrewを使用するMac：ターミナルでbrew install nodeを実行します。
• Linux：パッケージマネージャーを使用します（例：Ubuntuのsudo apt install nodejs）。

インストールが完了したら、何もダウンロードすることなくサーバーを直接実行できます。

1. Lunchmoneyの開発者設定からLunchmoney APIトークンを取得します。
2. Claude Desktopを開きます。
3. 設定 → 開発者 → 編集設定に移動します。
4. 以下の設定を追加します。

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["-y", "lunchmoney-mcp-server"],
      "env": {
        "LUNCHMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

your_token_hereを実際のLunchmoney APIトークンに置き換えてください。

⚠️ 重要な注意事項

設定を変更した後、Claudeを再起動する必要がある場合があります。

💻 使用例

• 最近の取引を取得：MCPサーバーにリクエストを送信して、過去7日間の取引記録を取得します。
• 取引を検索：キーワードまたはカテゴリを指定して特定の取引を絞り込みます。
• カテゴリ別の支出：さまざまなカテゴリの総支出額を分析します。
• 予算の概要：各予算項目の現在の残高と使用状況を確認します。

📚 ドキュメント

モデルコンテキストプロトコル（MCP）は、さまざまなAIサービスとデータソースを接続するための標準化されたインターフェースです。MCPを使用すると、より効率的なデータやり取りとタスク処理が可能になります。

🔧 トラブルシューティング

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

1. Node.jsが正しくインストールされていることを確認します。
2. Lunchmoney APIトークンが有効であることを確認します。
3. ネットワーク接続が正常であることを確認します。
4. MCPサーバーのログを確認して、詳細な情報を取得します。

📄 APIの説明

• 日付範囲：予算はYYYY-MM-DD形式（例：2024-01-01から2024-01-31）です。
• 取引範囲：任意の日付範囲を使用できます。
• 通貨値：すべての金額は元の通貨で返されます。

📄 ライセンス

MIT