YNAB MCP Server
MCP-сервер к YNAB: агент читает бюджеты, счета и категории, создает и правит транзакции по личному токену, запуск через uvx.
- 100 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токен открывает бюджеты аккаунта и позволяет создавать, менять и удалять транзакции.
- Финансовые данные из ответов инструментов попадают в контекст модели и к ее провайдеру.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ynab-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен открывает бюджеты аккаунта и позволяет создавать, менять и удалять транзакции.
- Финансовые данные из ответов инструментов попадают в контекст модели и к ее провайдеру.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на FastMCP превращает все эндпоинты YNAB API в инструменты MCP. Агент получает бюджеты, счета, категории, получателей платежей, месяцы и транзакции, умеет создавать, менять, удалять и импортировать транзакции, а также вести запланированные платежи. В репозитории лежит папка `.skills` со скиллом skill-creator. С его помощью личные правила учета, например категоризацию покупок и удаление дублей между банком и Venmo, превращают в отдельный скилл, который агент применяет сам.
Для кого. Пользователям YNAB, которые разбирают неутвержденные транзакции и дубли с помощью Claude Code, Cursor или Claude Desktop.
Подходит, если
- Накопились неутвержденные транзакции, и их надо разложить по категориям.
- Нужно найти дубли между выпиской банка и записью в Venmo.
- Вопросы про остаток на счете и траты за месяц задают прямо в чате.
- Свои правила учета хочется записать один раз в скилл и применять каждый раз.
Не подходит, если
- Нет личного токена YNAB: доступ идет только по Personal Access Token.
- Данные бюджета нельзя показывать модели: транзакции уходят агенту и провайдеру модели.
- Нужны только чтение и отчеты: токен открывает и изменение данных.
Пример запроса к агенту
Покажи неутвержденные транзакции за прошлую неделю и предложи категории, ничего не меняя без моего подтверждения.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
YNAB_API_TOKENобязательная, секрет- Personal Access Token из Developer Settings YNAB.
Ограничения
Нужны менеджер пакетов uv и личный токен YNAB из Account Settings, Developer Settings. Токен показывается один раз и открывает бюджеты аккаунта, в конфигурации клиента он лежит в переменной `YNAB_API_TOKEN`. Сервер публикует все эндпоинты API, включая `createTransaction`, `updateTransaction` и `deleteTransaction`, поэтому ошибка агента меняет реальные данные бюджета. Отдельного режима только для чтения в документации нет. Скиллы с вашими правилами создают сами: в репозитории лежит только skill-creator.
Как отключить. Выполните `claude mcp remove ynab --scope user` или с `--scope local`, либо удалите запись ynab из конфигурации клиента. Токен уберите оттуда же.
Частые вопросы
Как получить токен YNAB?
В app.ynab.com откройте Account Settings, затем Developer Settings, нажмите New Token под Personal Access Tokens и сохраните токен сразу: повторно его не покажут.
Как подключить YNAB MCP к Claude Code?
Выполните `claude mcp add ynab --scope user -e YNAB_API_TOKEN=<токен> -- uvx ynab-mcp-tools`. Проверить подключение можно командой `claude mcp list`.
Какие инструменты доступны?
Среди них `getBudgets`, `getAccounts`, `getCategories`, `getTransactions`, `createTransaction`, `importTransactions` и `getScheduledTransactions`. Сервер публикует все эндпоинты YNAB API.
Для чего нужна папка .skills?
В ней лежит skill-creator. Он помогает превратить ваши правила категоризации и удаления дублей в собственный скилл, который агент применяет сам.
Нужно ли клонировать репозиторий?
Нет. Пакет ynab-mcp-tools запускается командой `uvx` из PyPI в изолированном окружении, клонирование и виртуальное окружение не нужны.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к Actual Budget: агент читает счета и транзакции, строит отчеты по расходам и по флагу правит категории и правила.
MCP-сервер для сервиса учета личных финансов LunchMoney: транзакции, бюджеты, категории и счета доступны агенту через API v2.
Actual MCP Server — Actual Budget для агента
Actual MCP Server
MCP-сервер на 85 инструментов для вашего Actual Budget: расходы, категории, правила и расписания по запросу агенту
MCP-сервер для личного анализа акций: рыночные данные, технические индикаторы, скрининг и учет портфеля без ключей для базовых функций
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Коротко о README
Сервер запускается командой `uvx ynab-mcp-tools` из PyPI без клонирования репозитория. Описаны конфигурации для Claude Desktop, Claude Code, Cursor и OpenCode, а также путь от интерактивной работы с бюджетом до собственного скилла.