FastMCPで構築されたYNAB(You Need A Budget)API用のMCP(Model Context Protocol)サーバーです。

このサーバーはすべてのYNAB APIエンドポイントを自動的にMCPツールとして公開し、ClaudeのようなAIアシスタントがYNABの予算、口座、取引などとやり取りできるようにします。

前提条件

• UVパッケージマネージャー
• APIアクセス権を持つYNABアカウント

セットアップ

YNAB APIトークンを入手

1. YNABアカウントにログイン app.ynab.com
2. アカウント設定 → 開発者設定へ移動
3. 「Personal Access Tokens」の新しいトークンをクリック
4. トークンに名前を付けて生成をクリックします
5. トークンをコピーする(もう見られなくなります!)

サーバーをMCPクライアントに追加してください

公開されたパッケージはuvx ynab-mcp-toolsで動作します。uvxはからダウンロードします。 PyPIを使い、独立した環境で実行しているので、クローンは不要です リポジトリまたは仮想環境管理。

クロードデスクトップで

Claude Desktopの設定ファイルに以下を追加する:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

クロード・コードと共に

Claude CodeのMCP CLIを使用してください。--

YNAB MCP Server

An MCP (Model Context Protocol) server for the YNAB (You Need A Budget) API, built with FastMCP.

This server automatically exposes all YNAB API endpoints as MCP tools, allowing AI assistants like Claude to interact with your YNAB budgets, accounts, transactions, and more.

Prerequisites

• uv package manager
• A YNAB account with API access

Setup

Get Your YNAB API Token

1. Log in to your YNAB account at app.ynab.com
2. Go to Account Settings → Developer Settings
3. Click New Token under “Personal Access Tokens”
4. Give your token a name and click Generate
5. Copy the token (you won’t be able to see it again!)

Add the Server to Your MCP Client

The published package runs with uvx ynab-mcp-tools. uvx downloads it from PyPI and runs it in an isolated environment, so you do not need to clone this repository or manage a virtualenv.

With Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ynab": {
      "command": "uvx",
      "args": ["ynab-mcp-tools"],
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

With Claude Code

Use Claude Code’s MCP CLI. The -- separates Claude’s options from the server command.

For all projects (user scope):

claude mcp add ynab --scope user \
  -e "YNAB_API_TOKEN=your-token-here" \
  -- uvx ynab-mcp-tools

For the current directory only, omit --scope user or use --scope local. Use claude mcp list to verify and claude mcp remove ynab --scope user (or local) to uninstall.

With Cursor

Add the following to your Cursor MCP settings (~/.cursor/mcp.json for global or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "ynab": {
      "command": "uvx",
      "args": ["ynab-mcp-tools"],
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

With OpenCode

Add the following to your OpenCode configuration file (~/.config/opencode/opencode.json):

{
  "mcp": {
    "ynab": {
      "type": "local",
      "command": ["uvx", "ynab-mcp-tools"],
      "enabled": true,
      "environment": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Available Tools

The server automatically exposes all YNAB API endpoints as MCP tools. Here are some of the available operations:

User

• getUser - Get authenticated user information

Budgets

• getBudgets - List all budgets
• getBudgetById - Get a single budget with all related entities
• getBudgetSettingsById - Get budget settings

Accounts

• getAccounts - List all accounts for a budget
• getAccountById - Get a single account