You Need A Budget (ynab) Mcp

YNAB MCP サーバー

You Need A Budget（YNAB）とシームレスに連携するための Model Context Protocol（MCP）サーバーです。このサーバーにより、AI アシスタントが YNAB の予算を操作できるようになり、強力な自動化機能や分析機能を利用できます。

クイックインストール（Claude Desktop）

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here",
      }
    }
  }
}

任意の環境変数：

"env": {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

機能

• 予算管理全般

  • 複数の予算を表示・管理
  • 口座残高と取引を追跡
  • カテゴリ別の支出と目標を監視

• 取引の管理

  • 取引の一覧表示と検索
  • 取引の詳細を更新
  • 受取人とカテゴリを管理

• 財務分析

  • 包括的な財務概要を取得
  • 支出パターンを追跡
  • 予算の進捗状況を監視

目次

• インストール
• プラットフォーム別のセットアップ
• 設定
• 利用可能なツール
• 使用例
• 開発
• 貢献
• ライセンス

インストールと使用方法

uvx を使用する場合、インストールは不要です：

# Run directly (recommended)
uvx ynab-mcp-server

# Or with specific version
uvx [email protected]

開発用：

# Clone and run from source
git clone https://github.com/yourusername/ynab-mcp-server.git
cd ynab-mcp-server
uv run ynab-mcp-server

プラットフォーム別のセットアップ

Claude Desktop

1. 設定ファイルを探します：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. YNAB MCP サーバーの設定を追加します：

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["ynab-mcp-server"],
      "env": {
        "YNAB_PAT": "your_token_here"
      }
    }
  }
}

任意の環境変数：

env: {
  "YNAB_DEFAULT_BUDGET_ID": "your_budget_id",
  "YNAB_READ_ONLY": "true"
}

Goose

1. Goose の設定を開きます
2. MCP Servers セクションに移動します
3. 次の内容で新しいサーバーを追加します：
   • 名前：ynab-mcp
   • コマンド：uvx ynab-mcp-server
   • 環境変数：
     • YNAB_PAT：your_token_here

その他のプラットフォーム

その他の MCP 対応プラットフォームでは、次のパラメーターを使用して設定します：

• サーバー名：ynab-mcp
• コマンド：uvx
• 引数：ynab-mcp-server
• 必須環境変数：YNAB_PAT

設定

環境変数を使用してサーバーを設定できます。これらの変数は、プロジェクトのルートにある .env ファイルに記述するか、シェルで設定できます。

変数	必須	説明
YNAB_PAT	はい	YNAB の個人用アクセストークンです。
YNAB_DEFAULT_BUDGET_ID	いいえ	設定すると、サーバーは常にこの予算 ID を使用する単一予算モードで動作します。list-budgets ツールは非表示になります。
YNAB_READ_ONLY	いいえ	true に設定すると、YNAB のデータを変更するすべてのツールが無効になります。

YNAB トークンの取得

1. YNAB トークンを取得する

   • YNAB Developer Settings にアクセスします
   • 新しい個人用アクセストークンを作成します
   • トークンの値をコピーします

2. 環境をセットアップする

   作業ディレクトリに .env ファイルを作成します：

   YNAB_PAT="your_token_here"
   YNAB_DEFAULT_BUDGET_ID="your_budget_id"
   YNAB_READ_ONLY="true"
   

   または、環境変数を直接設定します：

   export YNAB_PAT="your_token_here"
   

利用可能なツール

このサーバーは、YNAB データを操作するためのツール群を提供します。各ツールの説明では、目的と推奨される使い方を紹介します。

ツール	説明
manage-financial-overview	財務概要を取得、更新、または再読み込みします。あらゆる分析の最適な出発点であり、口座残高、目標、重要なコンテキストメモを確認できます。
list-accounts	指定した予算のすべての口座を一覧表示します。他のツールで使う口座 ID の取得に便利です。
get-month-info	ある 1 か月分の詳細な予算情報を取得します。資金の経過期間や、予算配分済み、支出済み、利用可能な金額などが含まれます。変更を加える前に、月次予算の状況を確認するために呼び出してください。
list-categories	すべてのカテゴリとグループ、およびそれらの予算情報を一覧表示します。予算配分額を管理する前に呼び出し、利用できる項目と、すでに配分されている金額を確認してください。
list-transactions	指定した口座または 1 か月分のすべての取引を一覧表示します。財務概要で特定した支出傾向の調査に使用します。
list-scheduled-transactions	今後予定されているすべての取引を一覧表示します。今後の請求を予測するのに便利です。
manage-budgeted-amount	カテゴリに予算配分額を割り当てるか、カテゴリ間で資金を移動します。資金配分の主要なツールです。（読み取り専用モードでは書き込み操作は無効です）
bulk-manage-transactions	複数の取引をまとめて作成、更新、削除します。個別に変更するより効率的です。（読み取り専用モードでは書き込み操作は無効です）
manage-scheduled-transaction	予定（定期）取引を 1 件作成、更新、削除します。定期的な請求や貯蓄口座への振替の管理に使用します。（読み取り専用モードでは書き込み操作は無効です）
list-payees	指定した予算のすべての受取先を一覧表示します。受取先 ID の検索や、統合が必要な整理されていない受取先データの特定に便利です。
manage-payees	複数の受取先名を 1 つの名前に統合します。受取先データの整理に使用します。（読み取り専用モードでは書き込み操作は無効です）
lookup-entity-by-id	ID を指定して、特定の口座、カテゴリ、または受取先の名前と詳細を検索します。ID はわかっているものの、詳しい情報が必要な場合に便利です。
lookup-payee-locations	受取先に関連付けられた地理的位置を検索します。
list-budgets	利用可能なすべての YNAB 予算を一覧表示します（単一予算モードでは利用できません）。

開発

ローカルセットアップ

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/ynab-mcp-server.git
   cd ynab-mcp-server
   

2. 依存関係をインストールします。

   uv sync
   

3. サーバーを起動します。

   uv run ynab-mcp-server
   

デバッグ

デバッグには MCP Inspector を使用します。

npx @modelcontextprotocol/inspector uvx ynab-mcp-server

ローカル開発時のデバッグには、以下を使用します。

cd path/to/ynab-mcp-server
npx @modelcontextprotocol/inspector uv run ynab-mcp-server

以下を使用してログを確認することもできます。

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

ビルドと公開

# Build package
uv build

# Publish to PyPI
uv publish

貢献

貢献を歓迎します。以下の方法でご協力いただけます。

1. リポジトリをフォークする
2. 機能ブランチを作成する（git checkout -b feature/amazing-feature）
3. 変更をコミットする（git commit -m 'Add amazing feature'）
4. ブランチにプッシュする（git push origin feature/amazing-feature）
5. プルリクエストを作成する

PR では、以下を確認してください。

• 既存のコードスタイルに従っていること
• 適切なテストが含まれていること
• 必要に応じてドキュメントが更新されていること

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

謝辞

• 中核となる機能を提供する YNAB API
• AI アシスタントとの連携を可能にする Model Context Protocol