YNAB MCP

YNAB MCP サーバー

YNAB（You Need A Budget）と連携するための Model Context Protocol（MCP）サーバーです。Claude Desktop など、MCP 対応クライアントを通じて予算データにアクセスするためのツールを提供します。

MCP クライアントの設定

基本設定

MCP クライアントの設定ファイル（Claude Desktop の cline_mcp_settings.json など）に次の内容を追加します。

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

詳細設定

特定のディレクトリから実行する場合は、次のように設定します。

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

デバッグ

MCP Inspector を使用してデバッグするには、次の手順を実行します。

1. Inspector をインストールします。

npm install -g @modelcontextprotocol/inspector

2. uv で Inspector を使用するように設定を更新します。

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Inspector では、次のことができます。

• ツール呼び出しと応答のリアルタイムログの確認
• リクエストと応答の検査
• ツールスキーマの検証
• 対話型テストインターフェイスの利用

利用可能なツール

GetUser

認証済みの YNAB ユーザーに関する情報（ユーザー ID やメールアドレスなど）を取得します。

ListBudgets

認証済みのユーザーがアクセスできるすべての予算を、予算 ID や名前とともに一覧表示します。

GetBudget

取引、カテゴリ、残高など、特定の予算に関する詳細情報を取得します。日付による絞り込みと取引数の制限を任意で指定できます。

注：金額はミリ単位で返されます（例：1000 = $1.00）。

GetBudgetCategories

指定した予算に定義されているすべてのカテゴリを、カテゴリグループ、名前、ID とともに取得します。

GetBudgetSettings

通貨形式、日付形式、その他の設定など、指定した予算の設定を取得します。