Skip to main content
Glama
deenesjakoruzh
justmytwospence

ynab-mcp

by justmytwospence
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ynab-mcp

MCP-сервер (Model Context Protocol), предоставляющий полный доступ к API YNAB, позволяя LLM читать ваш бюджет и управлять им с помощью естественного языка. Предоставляет инструменты для операций CRUD, ресурсы для контекста бюджета и промпты для пошаговых финансовых рабочих процессов.

Требования

Related MCP server: YNAB MCP Server

Установка

npm install -g ynab-mcp

Или установите из исходного кода:

git clone https://github.com/justmytwospence/ynab-mcp.git
cd ynab-mcp
npm install
npm run build
npm install -g .

Конфигурация

Установите ваш токен API YNAB в качестве переменной окружения:

export YNAB_API_TOKEN="your-token-here"

Сгенерируйте токен в разделе YNAB > Account Settings > Developer Settings.

Claude Code

claude mcp add ynab-mcp ynab-mcp -e YNAB_API_TOKEN=your-token-here

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "ynab-mcp",
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Инструменты

50 инструментов, охватывающих весь API YNAB. Все денежные суммы используют формат миллиединиц YNAB (например, $12.34 = 12340).

Учет ограничений частоты запросов (Rate limit)

API YNAB ограничивает использование до 200 запросов в час (скользящее окно) на токен. Сервер отслеживает каждый вызов и предоставляет:

  • Инструмент get_api_usage / ресурс ynab://api-usage — явная проверка по запросу (0 вызовов API).

  • Автоматические предупреждения, добавляемые к результату каждого инструмента при достижении лимита:

    • [RATE LIMIT WARNING] при 50 или менее оставшихся запросах

    • [RATE LIMIT CRITICAL] при 20 или менее оставшихся запросах

    • [RATE LIMIT REACHED] при 0 оставшихся запросах

Описание каждого инструмента включает стоимость вызова API в скобках (например, [1 API call]). Отдавайте предпочтение пакетным инструментам (create_transactions, update_transactions) вместо циклов с одиночными вызовами.

Пользователь

Инструмент

Описание

get_user

Получить информацию об аутентифицированном пользователе

Бюджеты

Инструмент

Описание

list_budgets

Список всех бюджетов с опциональной информацией о счетах

get_budget

Получить полные данные бюджета, включая все сущности

get_budget_settings

Получить настройки формата даты и валюты

Счета

Инструмент

Описание

list_accounts

Список всех счетов с балансами и типами

get_account

Получить детали конкретного счета

create_account

Создать новый счет

Категории

Инструмент

Описание

list_categories

Список всех категорий, сгруппированных по группам категорий

get_category

Получить детали конкретной категории

create_category

Создать новую категорию

update_category

Обновить название, заметку или цель категории

get_month_category

Получить бюджет категории на конкретный месяц

update_month_category

Обновить бюджетную сумму для категории в конкретном месяце

create_category_group

Создать новую группу категорий

update_category_group

Обновить название группы категорий

Транзакции

Инструмент

Описание

list_transactions

Список транзакций с опциональными фильтрами

get_transaction

Получить детали конкретной транзакции

create_transaction

Создать новую транзакцию

create_transactions

Пакетное создание нескольких транзакций

update_transaction

Обновить существующую транзакцию

update_transactions

Массовое обновление нескольких транзакций

delete_transaction

Удалить транзакцию

import_transactions

Импорт из связанных финансовых учреждений

list_account_transactions

Список транзакций для конкретного счета

list_category_transactions

Список транзакций для конкретной категории

list_payee_transactions

Список транзакций для конкретного получателя

list_month_transactions

Список транзакций за конкретный месяц

Запланированные транзакции

Инструмент

Описание

list_scheduled_transactions

Список всех запланированных/повторяющихся транзакций

get_scheduled_transaction

Получить детали запланированной транзакции

create_scheduled_transaction

Создать новую запланированную транзакцию

update_scheduled_transaction

Обновить запланированную транзакцию

delete_scheduled_transaction

Удалить запланированную транзакцию

Получатели

Инструмент

Описание

list_payees

Список всех получателей

get_payee

Получить детали конкретного получателя

update_payee

Обновить название получателя

Местоположения получателей

Инструмент

Описание

list_payee_locations

Список всех GPS-местоположений получателей

get_payee_location

Получить конкретное местоположение получателя

get_payee_locations_for_payee

Получить все местоположения для конкретного получателя

Месяцы

Инструмент

Описание

list_months

Список всех месяцев бюджета со сводками

get_month

Получить детальную информацию о месяце с балансами категорий

Перемещения средств

Инструмент

Описание

list_money_movements

Список всех перемещений средств

get_month_money_movements

Получить перемещения средств за конкретный месяц

list_money_movement_groups

Список всех групп перемещения средств

get_month_money_movement_groups

Получить группы перемещения средств за конкретный месяц

Рабочие процессы

Инструмент

Описание

merge_category

Объединить исходную категорию с целевой, переместив все транзакции и бюджетные суммы

delete_category

Подготовка категории к удалению: перекатегоризация всей истории в заменяющую категорию и обнуление бюджетов (окончательное удаление выполняется вручную в приложении YNAB — ограничение API)

audit_credit_card_payments

Аудит балансов категорий платежей по кредитным картам относительно балансов карт, с опциональным автоисправлением

Ресурсы

Ресурсы предоставляют структурированные данные бюджета, которые клиенты могут использовать в контексте без вызова инструментов. Шаблонные ресурсы используют параметры URI (например, {budget_id}).

Ресурс

URI

Описание

Стоимость API

Использование API

ynab://api-usage

Текущий статус лимитов: использованные вызовы, оставшиеся, сброс окна

0

Сводка бюджета

ynab://budgets/{budget_id}/summary

Обзор бюджета со счетами, балансами и группами категорий

1

Список счетов

ynab://budgets/{budget_id}/accounts

Все счета с типом, балансом, очищенными/неочищенными балансами

1

Ежемесячные категории

ynab://budgets/{budget_id}/months/{month}/categories

Все категории за месяц с бюджетом, активностью и балансом

1

Промпты

Промпты — это шаблоны рабочих процессов, которые пользователи могут вызывать для выполнения типичных задач бюджетирования. Они инструктируют LLM, какие инструменты вызывать и как интерпретировать результаты.

Промпт

Аргументы

Описание

monthly-review

budget_id, month

Обзор месяца бюджета: перерасходованные категории, отклонения в расходах, недофинансированные цели, несоответствия по кредитным картам

transaction-audit

budget_id, account_id, since_date

Аудит транзакций на предмет некатегоризированных, неутвержденных, дубликатов и необычных сумм

budget-setup-guide

budget_id

Пошаговое руководство: счета, категории, цели, запланированные транзакции, распределение средств

spending-analysis

budget_id, month

Разбивка по категориям, бюджет против факта, топ получателей, доходы против расходов

credit-card-audit

budget_id, since_month?

Аудит балансов категорий платежей по кредитным картам с предварительным тестовым прогоном и подтверждением перед применением

Разработка

npm run dev    # Watch mode with tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server

Лицензия

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • YNAB MCP Server

    ntdef
    A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that enables interaction with You Need A Budget (YNAB) via their API, allowing users to manage budgets, accounts, categories, and transactions through natural language.
    2
    MIT

  • YNAB MCP Server

    chrisguidry
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides Large Language Models with access to YNAB (You Need A Budget) budgets, allowing them to fetch budget data including accounts, categories, and category groups.
    6

  • YNAB MCP Server

    WGDevelopment
    A
    license
    A
    quality
    D
    maintenance
    A minimal and auditable MCP server that enables local AI assistants to read and manage YNAB budget data. It supports operations like listing accounts, tracking transactions, and moving money between categories while maintaining user privacy.
    9
    MIT

  • YNAB MCP Server

    rgarcia
    A
    license
    B
    quality
    C
    maintenance
    Exposes YNAB API endpoints as MCP tools, allowing AI assistants to manage budgets, accounts, transactions, and more through natural language.
    44
    90
    MIT

View all related MCP servers

Related MCP Connectors

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • ynab-mcp-server

    Hosted remote MCP server for YNAB on Cloudflare Workers with OAuth

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/justmytwospence/ynab-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server