ynab-mcp-server
mcp-frameworkで構築されたモデルコンテキストプロトコル（MCP）サーバー。このMCPは、 https://ynab.comにあるYNAB予算設定を操作するためのツールを提供します。
AIがこのツールと連携するには、YNABから個人アクセストークンを取得する必要があります： https://api.ynab.com/#personal-access-tokens 。このMCPサーバーをクライアントに追加する際は、個人アクセストークンをYNAB_API_TOKENとして提供する必要があります。このトークンはLLMに直接送信されることはありません。YNAB APIで使用するために、環境変数に非公開で保存されます。
設定
環境変数を指定します:
YNAB_API_TOKEN（必須）
YNAB_BUDGET_ID（オプション）
Related MCP server: MCP YNAB Server
ゴール
このプロジェクトの目標は、AIとの会話を通じてYNABの予算管理ツールとやり取りできるようにすることです。実現したい主なワークフローは以下のとおりです。
ワークフロー:
初回セットアップ
利用可能な予算の中から予算を選択するよう求められます。最初に別のツールを使用しようとすると、デフォルトの予算を設定するよう求めるプロンプトが表示されます。
必要なツール: ListBudgets
支出超過カテゴリーを管理する
新しい取引を追加する
取引の承認
毎月の総支出と総収入を確認する
カテゴリー目標に基づいて資金を割り当てる準備ができた自動配分
現在の状態
利用可能なツール:
ListBudgets - アカウントで利用可能な予算を一覧表示します
BudgetSummary - 資金が不足しているカテゴリと低いアカウントの概要を提供します
GetUnapprovedTransactions - 承認されていないすべての取引を取得する
CreateTransaction - 指定された予算とアカウントのトランザクションを作成します。
例:
Add a transaction to my Ally account for $3.98 I spent at REI todayアカウントIDを知るために、まずGetBudgetを呼び出す必要があります
ApproveTransaction - YNAB予算内の既存の取引を承認します
承認には取引IDが必要です
GetUnapprovedTransactionsと組み合わせて使用することで、保留中の取引を承認することができます。
承認されていない取引を取得した後、プロンプト：
approve the transaction for $6.95 on the Apple Card
次：
1回の呼び出しで複数の取引を承認できる
updateCategory ツール - または、オプションパラメータを取得して zod および mcp フレームワークで正しく動作させることができれば、より一般的な updateTransaction ツール
MCP フレームワークから移行して、モデル コンテキスト プロトコル SDK を直接使用しますか?
クイックスタート
プロジェクト構造
コンポーネントの追加
YNAB SDK では、利用可能な API エンドポイントについて説明します: https://github.com/ynab/ynab-sdk-js 。
YNABオープンAPI仕様はこちらです： https://api.ynab.com/papi/open\ _api\_spec.yaml 。これを使用して、AIに新しいツールを生成するよう指示することができます。カーソルエージェントのプロンプトの例：
CLI を使用してさらにツールを追加できます。
ツール開発
ツール構造の例:
npmへの公開
package.json を更新します。
nameが一意であり、npm の命名規則に従っていることを確認してください。適切な
versionを設定するdescription、author、licenseなどを追加します。binが正しいエントリファイルを指しているか確認する
ローカルでビルドしてテストします。
npm run build npm link ynab-mcp-server # Test your CLI locallynpm にログインします (必要に応じてアカウントを作成します)。
npm loginパッケージを公開します:
npm publish
公開後、ユーザーはそれをクロードデスクトップクライアント（下記参照）に追加したり、npxで実行したりすることができます。
Claude Desktopでの使用
Smithery経由でインストール
Smithery経由で Claude Desktop 用の YNAB Budget Assistant を自動的にインストールするには:
地域開発
この構成を Claude Desktop 構成ファイルに追加します。
MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json
公開後
この構成を Claude Desktop 構成ファイルに追加します。
MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json
その他のMCPクライアント
利用可能な他のクライアントについては、 https://modelcontextprotocol.io/clientsを確認してください。
構築とテスト
ツールに変更を加える
npm run buildを実行してコンパイルするサーバーは起動時にツールを自動的に読み込みます