ynab-mcp-server

ynab-mcp-server

ホスト型 MCP サーバーを使って、YNAB を ChatGPT または Claude に接続します。

自分の YNAB アカウントにサインインした後、AI アシスタントで YNAB のプラン、カテゴリ、取引、目標を読み取って管理したり、残高や純資産を確認したりする場合にご利用ください。

必要なもの

• YNAB アカウント
• ホスト型 MCP URL：https://mcpforynab.smirnovlabs.com/mcp
• カスタム MCP コネクタに対応した ChatGPT または Claude

クイックスタート

1. ホスト型 MCP URL を取得します。
2. その URL を ChatGPT または Claude に追加します。
3. ［接続］をクリックします。
4. プロンプトが表示されたら、YNAB にサインインします。
5. チャットに戻り、YNAB について質問を始めます。

Claude では、上部の Claude に追加 ボタンで手順 1 と 2 を実行できます。Claude でのセットアップをご覧ください。

ChatGPT でのセットアップ

以下の手順は ChatGPT ウェブアプリ向けです。

2026 年 3 月 25 日現在、OpenAI ではカスタム MCP コネクタを利用するために開発者モードが必要です。

始める前に

• カスタム MCP コネクタに対応した ChatGPT プランが必要です。
• ワークスペースプランをご利用の場合、管理者が先に開発者モードを有効にする必要がある場合があります。
• 次のホスト型 MCP URL が必要です：https://mcpforynab.smirnovlabs.com/mcp。

手順

1. chatgpt.com を開きます。
2. ［設定］を開きます。
3. まだ有効になっていない場合は、開発者モードを有効にします。
4. ［アプリ］または［コネクタ］に移動し、カスタムアプリまたはコネクタの作成を選択します。
5. ホスト型 MCP URL を貼り付けます。
6. ChatGPT から認証方法を求められたら、OAuth を選択します。
7. コネクタを保存または作成します。
8. 新しいチャットを開始します。
9. ツールメニューを開き、新しいコネクタを有効にします。
10. リダイレクトされたら、YNAB にサインインしてアクセスを承認します。
11. ChatGPT に戻り、テスト用のプロンプトを送信します。

最初に試すプロンプト

• Show me the balances of all my plan accounts.
• List my plan categories with available amounts.
• Find my most recent grocery transactions.
• What were my largest spending categories last month?

Claude でのセットアップ

以下の手順は claude.ai 向けです。

2026 年 10 月 25 日現在、Claude ではカスタムコネクタは Customize > Connectors にあります。

始める前に

• Free、Pro、Max、Team、Enterprise プランではカスタムコネクタを利用できます。Free プランでは 1 つ追加できます。
• ホスト型 MCP URL は https://mcpforynab.smirnovlabs.com/mcp です。Claude に追加 ボタンを使うと自動で入力されます。
• Claude Team または Enterprise では、組織のオーナーが先にコネクタを追加する必要があります。

Claude Free、Pro、Max での手順

1. このページの上部にある Claude に追加 をクリックします。
2. プロンプトが表示されたら、Claude にサインインします。
3. Claude で Add custom connector ダイアログが開き、フィールドに値が入力されます。また、外部リンクから値が取得されたことを示す通知も表示されます。名前が YNAB、URL が https://mcpforynab.smirnovlabs.com/mcp であることを確認します。
4. ダイアログに Authentication と OAuth client の設定が表示されたら、Sign in now と Register automatically を選択します。このサーバーは Use Claude's published identity に対応していません。
5. Add をクリックします。
6. Connect をクリックします。
7. リダイレクトされたら、YNAB にサインインしてアクセスを承認します。
8. 新しいチャットを開始します。
9. + をクリックし、Connectors を選択して、YNAB をオンにします。
10. テスト用のプロンプトを送信します。

コネクタを手動で追加するには、Customize > Connectors に移動し、Add custom connector をクリックします。名前に YNAB、ホスト型 MCP URL に該当の URL を入力し、手順 4 から続けます。

Claude Team または Enterprise の手順

組織のオーナーがコネクタを一度追加します。その後、各メンバーが自分の YNAB アカウントを接続します。

オーナーの場合：

1. 組織のインストールリンクを開きます。Claude に組織の Add custom connector ダイアログが表示され、名前と URL が入力された状態になります。
2. ダイアログに Authentication と OAuth client の設定が表示される場合は、Sign in now と Register automatically を選択します。
3. Add をクリックします。

手動で追加する場合は、Organization settings > Connectors に移動して Add、次に Custom を選択します。名前に YNAB、ホストされた MCP URL を入力し、ステップ 2 から続けます。

各メンバーの場合：

1. Customize > Connectors に移動します。
2. オーナーが追加したコネクタを探します。Custom ラベルが付いています。
3. Connect をクリックします。
4. リダイレクトされたら、YNAB にサインインしてアクセスを承認します。
5. 新しいチャットを開始します。
6. + をクリックして Connectors を選択し、コネクタをオンにします。
7. テスト用のプロンプトを送信します。

最初に試すのに適したプロンプト

• Show me my current account balances in YNAB.
• What categories are overspent right now?
• Find transactions from Amazon in the last 30 days.
• Summarize my spending by category this month.

接続するとどうなるか

1. ChatGPT または Claude がホストされた MCP URL に接続します。
2. MCP サーバーから YNAB のサインイン画面に移動します。
3. YNAB アカウントへのアクセスを承認します。
4. サービスは、今後 YNAB にリクエストを送信するために必要な OAuth トークンを保存します。
5. これにより、アシスタントはチャットで YNAB のツールとリソースを利用できるようになります。

利用可能なツール

接続すると、アシスタントは以下のツールを利用できます。Read ツールはデータを参照するだけです。Write ツールは予算を変更します（delete と記されたものはデータを削除します）。

予算とセットアップ

ツール	機能	アクセス
ynab_list_budgets	YNAB の予算を一覧表示します	Read
ynab_budget_summary	カテゴリー、残高、アカウントの月次サマリーを表示します	Read
ynab_set_default_budget	毎回名前を指定しなくてもよいよう、既定の予算を記憶します	Setup

カテゴリーと目標

ツール	機能	アクセス
ynab_list_categories	残高と目標を含むカテゴリーグループとカテゴリーを一覧表示します	Read
ynab_create_category	グループ内にカテゴリーを作成します	Write
ynab_update_category	カテゴリー名の変更、メモの編集、または別のグループへの移動を行います	Write
ynab_create_category_group	カテゴリーグループを作成します	Write
ynab_update_category_group	カテゴリーグループ名を変更します	Write
ynab_set_category_goals	カテゴリーの目標を作成、更新、または削除します	Write

取引

ツール	機能	アクセス
ynab_list_transactions	アカウント、カテゴリー、受取人、または日付で取引を一覧表示・絞り込みします	Read
ynab_get_unapproved_transactions	承認待ちの取引を一覧表示します	Read
ynab_create_transaction	取引を追加します	Write
ynab_update_transaction	既存の取引を編集します	Write
ynab_approve_transaction	保留中の取引を1件承認します	Write
ynab_bulk_approve_transactions	保留中の取引をまとめて承認します	Write
ynab_delete_transaction	取引を削除します	Write (delete)

予定された（定期的な）取引

ツール	機能	アクセス
ynab_list_scheduled_transactions	予定された／定期的な取引を一覧表示します	Read
ynab_create_scheduled_transaction	将来の取引または定期的な取引を予定します	Write
ynab_update_scheduled_transaction	予定された取引を編集します	Write
ynab_delete_scheduled_transaction	予定された取引を削除します	Write (delete)

予算管理のワークフロー

ツール	内容	アクセス
ynab_move_funds_between_categories	予算を割り当てた資金をカテゴリ間で移動します	書き込み
ynab_auto_distribute_funds	「割り当て準備完了」の資金を、目標に応じてカテゴリに配分します	書き込み
ynab_handle_overspending	資金を移動して、支出超過のカテゴリを補填します	書き込み
ynab_budget_from_history	過去の支出に基づいて資金を配分します	書き込み
ynab_reconcile_account	口座残高を明細書の残高と照合します	書き込み

分析とインサイト（読み取り専用）

ツール	内容
ynab_analyze_spending_patterns	支出の傾向や異常を見つけます
ynab_goal_progress_report	カテゴリの目標に対する進捗を追跡します
ynab_cash_flow_forecast	過去のデータから今後のキャッシュフローを予測します
ynab_category_performance_review	カテゴリごとの予算と実績を比較します
ynab_net_worth_analysis	口座全体の純資産をまとめます

YNAB API の対応状況

これらのツールと公式の YNAB API（ynab JavaScript SDK を通じてアクセス）の対応状況です。✅ = 対応済み、◐ = 一部対応、— = 未対応です。

YNAB API の領域	対応状況	ツール／注記
予算（プラン）	✅	ynab_list_budgets、ynab_budget_summary。プランの設定は公開されていません
口座	◐	残高は ynab_budget_summary、ynab_net_worth_analysis、ynab_reconcile_account で読み取れます。口座の作成や、単独の口座一覧には対応していません
カテゴリとグループ	✅	カテゴリとグループの一覧表示、作成、更新に対応。目標、月ごとの資金割り当てにも対応
月	✅	ynab_budget_summary と分析ツールを通じて利用できます
取引	✅	一覧表示、作成、更新、削除、承認、一括承認に対応（ファイルの import は公開されていません）
予定された取引	✅	一覧表示、作成、更新、削除に対応
受取人	—	取引ツールでは名前で暗黙的に参照されますが、受取人の一覧表示／更新ツールはありません
受取人の場所	—	公開されていません
ユーザー	—	認証は OAuth で処理されます。getUser は公開されていません

このサーバーでは、API の機能に加えて、単一の API エンドポイントに対応しない複合ツールも提供します。具体的には、予算管理のワークフロー（資金の移動、自動配分、支出超過への対応、過去の履歴に基づく予算設定、照合）と分析ツール（支出パターン、目標の進捗、キャッシュフロー、カテゴリの実績、純資産）です。

トラブルシューティング

ChatGPT にコネクターが表示されない

• ご利用のプランがカスタム MCP コネクターに対応していることを確認してください。
• 開発者モードが有効になっていることを確認してください。
• ワークスペースプランをご利用の場合は、管理者が必要な設定を有効にしていることを確認してください。

Claude にコネクターが表示されない

• ご利用のプランがリモート MCP コネクターに対応していることを確認してください。
• Team または Enterprise をご利用の場合は、ワークスペースのオーナーが先にコネクターを追加していることを確認してください。

接続しましたが、YNAB ツールが動作しない

• コネクターを切断してから、再接続してください。
• YNAB OAuth の承認手順を完了したことを確認してください。
• 新しいチャットを開始し、その会話でコネクターを再度有効にしてください。

MCP URL が機能しない

• HTTPS URL 全体を貼り付けたことを確認してください。
• ホストされた URL に末尾の /mcp が含まれている場合は、削除しないでください。

プライバシー

このサービスは OAuth を使用して YNAB アカウントに接続します。YNAB のパスワードを直接求めることはありません。

このアプリは、いかなる形でも YNAB から公式サポートを受けていません。ご自身の責任でご利用ください。

プライバシーポリシーはこちらをご覧ください。

• PRIVACY.md

セルフホストまたは運用担当者向け

このサービスをご自身でデプロイまたはホストする場合は、CONTRIBUTING.mdをご覧ください。 この README は、ChatGPT または Claude でホストされたサービスに接続するエンドユーザー向けに意図的に書かれています。