Сервер MCP (Model Context Protocol) для API YNAB (You Need A Budget), построенный с использованием FastMCP.

Этот сервер автоматически предоставляет все конечные точки YNAB API как инструменты MCP, позволяя AI-ассистентам, таким как Claude, взаимодействовать с вашими бюджетами, счетами, транзакциями и другим YNAB.

Предварительные требования

• Менеджер пакетов UV
• Учетная запись YNAB с доступом к API

Подготовка

Получите свой YNAB API Token

1. Войдите в свой аккаунт YNAB по адресу app.ynab.com
2. Перейдите в Настройки аккаунта → Настройки разработчика
3. Нажмите Новый токен в разделе «Персональные токены доступа»
4. Дайте своему токену имя и нажмите Генерировать
5. Скопируйте токен (вы больше его не увидите!)

Добавьте сервер в свой MCP-клиент

Опубликованный пакет работает с uvx ynab-mcp-tools. uvx скачает его с PyPI и запускает его в изолированной среде, так что клонировать это не нужно Репозиторий или управление виртуальным ENV.

С Claude Desktop

Добавьте следующее в ваш конфигурационный файл Claude Desktop:

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

С Клод Кодом

Используйте MCP CLI Claude Code. --

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