イナブ-MCP

YNAB MCP サーバー

YNAB（You Need A Budget）と連携するためのモデルコンテキストプロトコル（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 を使用してデバッグするには:

インスペクターをインストールします。

npm install -g @modelcontextprotocol/inspector

UV でインスペクターを使用するように設定を更新します。

{
  "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": []
    }
  }
}

検査官は以下を提供します:

ツールの呼び出しと応答のリアルタイムログ
リクエスト/レスポンス検査
ツールスキーマ検証
インタラクティブなテストインターフェース

利用可能なツール

ユーザーを取得

ユーザー ID や電子メールなど、認証された YNAB ユーザーに関する情報を取得します。

リスト予算

予算 ID と名前を含む、認証されたユーザーがアクセスできるすべての予算を一覧表示します。

予算を取得

特定の予算に関する詳細情報（取引、カテゴリ、残高など）を取得します。オプションで日付フィルタリングと取引制限もサポートします。

注: 金額はミリ単位で返されます (例: 1000 = $1.00)。

予算カテゴリを取得する

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

予算設定の取得

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

ynab-mcp