Lunch Money MCP (Unofficial)

エージェント向け Lunch Money

Lunch Money のデータについて、AI エージェントに質問できます。

ウェブサイト · セットアップガイド · プライバシー · 問題を報告

Lunch MoneyをAI エージェントで使いやすくするために、これを作成しました。 Model Context Protocol（MCP）に対応したツールにアカウントを接続することで、 会話形式で支出、予算、口座、定期的な支出について質問できます。

これはn3wthによる非公式のオープンソース MCP 統合です。 Lunch Money とは提携、推奨、スポンサー関係にありません。

質問できること

• 「先週の取引をカテゴリ別にまとめて表示してください。」
• 「今月の支出は予算と比べてどうですか？」
• 「定期的な支出を一覧表示してください。」
• 「口座残高を教えてください。通貨ごとに分けてください。」

この統合により、エージェントは基盤となる記録にアクセスでき、その結果を使って回答します。 金融データへのアクセスは読み取り専用です。取引の編集、予算の変更、資金の移動はできません。接続ツールでは、サービスとの接続をリンク、置換、削除できます。

アカウントを接続する

Lunch Money アカウント、個人用アクセストークン、OAuth サインインによるリモートサーバーに対応した MCP クライアントが必要です。

1. 以下のクライアントのセットアップ手順に従って、サーバーを追加します。
2. auth.n3wth.comでサインインします。 Lunch Money へのログインとは別に、コネクターのセッションが作成されます。
3. Lunch Money に接続するようエージェントに依頼します。 lunchmoney_connectを実行し、ブラウザーで開くリンクを提示するはずです。
4. リンクを開き、Nango の接続ページにトークンを入力します。 Lunch Money の開発者ページでRequest New Access Tokenをクリックしてトークンを作成します（ラベルと用途の入力は任意です）。チャットや MCP の設定には絶対に貼り付けないでください。
5. 「Lunch Money の口座を一覧表示して」のような簡単なリクエストを試します。

ホストされたエンドポイントは次のとおりです。

https://mcp.lunchmoney.sh/mcp

クライアント別のインストール

ウェブサイトでアプリを選択するか、以下から直接インストールします。

Claude Code — Claude Code 内で実行します。

/plugin marketplace add n3wth/lunchmoney-mcp
/plugin install lunchmoney@lunchmoney-mcp

Codex — ターミナルで実行します。

codex plugin marketplace add n3wth/lunchmoney-mcp
codex plugin add codex-plugin@lunchmoney-mcp

Codex アプリでは、Plugins → Create menu → Add marketplaceを選択して n3wth/lunchmoney-mcpを追加し、Lunch Moneyをインストールします。 Cursor — Cursor に追加、 Cursor ディレクトリの掲載ページから追加するか、 ウェブサイトでCursorを選択します。 インストール後に新しいセッションを開始してサインインし、「Connect Lunch Money」と質問してください。

カスタムマーケットプレイスは、審査済みディレクトリの承認とは別扱いです。 詳しい手順と手動での代替方法：

クライアント	手順
Codex	プラグインと手動セットアップ
Claude Code	プラグインのセットアップ
Cursor	プラグインと MCP の設定
その他の MCP クライアント	接続ガイド

ホスト型サービスはベータ版です。直接セットアップを利用できます。ディレクトリへの申請は、プラグインの承認や掲載を意味しません。 審査状況については申請記録、未完了のリリース確認項目については 運用手順書をご覧ください。

データの送信先

サインインと Lunch Money への接続は別々の手順です。

サービス	役割
Auth0	auth.n3wth.com でサインインを行い、コネクターアカウントを識別します。
Nango	ブラウザーフローを通じて Lunch Money のトークンを収集し、保存します。
Cloudflare	MCP サーバーを実行し、ID と接続の記録を保存します。
Lunch Money	API を通じて要求された金融記録を返します。
AI クライアント	結果を受け取り、モデルプロバイダーに送信する場合があります。
Vercel	ウェブサイトをホストし、リクエストを MCP サーバーにルーティングします。

サーバーは必要に応じて Nango からトークンを取得し、金融データの読み取りのみを許可します。Lunch Money では、トークンにそれより広い権限が付与されている場合があります。金融データへの応答はコネクターのデータベースには保存されませんが、受け取った結果には、AI クライアントのプライバシー設定と保持設定が適用されます。

接続を解除するには、エージェントに lunchmoney_disconnect を実行するよう依頼してください。削除に失敗した場合は、成功するまで再試行してください。トークンをほかの場所でも使えないようにするには、Lunch Money で元のトークンを取り消してください。クライアントプラグインを削除しても、接続の解除やトークンの取り消しは行われません。

保存と保持、プロバイダーの詳細についてはプライバシーに関する通知を読み、アカウントを接続する前にサービス利用規約もご確認ください。

注意点

取引データはページ単位で取得されます。 1 回の応答では、指定した日付範囲全体を取得できない場合があります。全体の合計を表示するには、next_offset が null になるまでエージェントが処理を続ける必要があります。

通貨は別々に扱ってください。 USD と CAD の金額を合計しても、有用な合計にはなりません。明示的に換算を希望する場合を除き、通貨ごとに合計を尋ねてください。

AI が生成した回答は間違っていることがあります。重要な回答については、Lunch Money の元の記録を確認してください。ユーザーガイドでは、ツールの一覧と接続に関するトラブルシューティングを説明しています。

プロジェクトへの取り組み

Node.js 22 以降を使用してください。サイトは静的な HTML と CSS で構成され、Vercel AI Elements で構築した小規模な React 会話プレビューが含まれています。

git clone https://github.com/n3wth/lunchmoney-mcp.git
cd lunchmoney-mcp
npm ci
npm run preview

これにより、サイトが http://localhost:4173 で起動します。サーバーを起動せずにビルドするには、npm run build を実行してください。出力先は dist/ です。

依存関係の順序に従って、サーバーのチェックを実行してください。

npm --prefix packages/auth-contract ci
npm --prefix packages/auth-contract test
npm --prefix packages/lunchmoney-adapter ci
npm --prefix packages/lunchmoney-adapter test
npm --prefix packages/server ci
npm --prefix packages/server test
node scripts/validate-release.mjs

ディレクトリ	内容
site/	ウェブサイト、スタイル、共有アイコン
packages/	MCP サーバー、認証コントラクト、API アダプター、クライアントプラグイン
docs/	セットアップ、運用、セキュリティ、提出記録
scripts/	リリース検証とスモークテスト

ステージング環境と本番環境では、別々の設定とデータベースを使用します。デフォルトの Worker コマンドはステージング環境を対象とします。デプロイ、認証情報、マイグレーション、ロールバックについては、運用手順書に従ってください。

Context7 によるドキュメントのインデックス作成

context7.jsonでは、Context7 がインデックスを作成するドキュメントを設定します。このファイルには、この README、ドキュメントの概要、接続、ツール、プライバシーに関するガイド、Codex、Claude Code、Cursor のセットアップガイドが含まれています。内部計画、運用記録、エージェントへの指示は除外されます。Context7 は、名前で除外されない限り、ルートにある Markdown ファイルを常に含めます。

このファイルをリポジトリのデフォルトブランチにマージした後、Context7 のライブラリ設定を開き、現在ダッシュボードで管理されている場合は、設定ソースをリポジトリの context7.json に切り替えてから、ライブラリを更新してください。インデックス対象のソースにセットアップガイドが含まれ、除外対象の記録が含まれていないことを確認してください。

サポートされているフィールドについては、Context7 の設定リファレンスをご覧ください。この設定はインデックス作成のみを制御します。ホストされた Docs7 サイトでは、別途 docs.json の設定が使われます。

貢献

バグ報告、より分かりやすいセットアップ手順、互換性の修正を歓迎します。 バグを報告する際は、使用したクライアント、期待した動作、サンプルデータを含む 最小限の例を記載してください。トークンや個人の金融記録は、イシューに記載しないでください。

大きな変更を行う前にイシューを作成し、変更範囲について合意してください。プルリクエストでは、 問題の内容と修正をどのように確認したかを説明してください。金融情報へのアクセスを 読み取り専用に保つことは、このプロジェクトの中核的な制約です。