# ynab-mcpb

Подключает YNAB к ИИ-ассистенту через MCP. Помогает сверять операции, разбирать чеки и анализировать расходы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: dizzlkheinz
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dizzlkheinz/ynab-mcpb
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/ynab-mcpb

## Что делает

ynab-mcpb подключает YNAB к MCP-клиенту и даёт управлять бюджетом через обычные запросы. Сервер умеет создавать операции, делить чек на позиции с распределением налога, сверять банковский CSV с транзакциями YNAB, искать пропущенные записи и показывать аналитику расходов. Доступны 35 инструментов для бюджетов, счетов, категорий, регулярных операций и периодов.

Записи проходят через режим предварительного просмотра с одноразовым подтверждением точного запроса. Можно выбрать профили `core`, `read-only` или `full`, а ответы получать в Markdown или JSON. Для работы нужен персональный токен YNAB, переданный через `YNAB_ACCESS_TOKEN`; без него сервер не подключится.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `YNAB_ACCESS_TOKEN`, `YNAB_MCP_WRITE_MODE`, `YNAB_MCP_TOOL_PROFILE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env YNAB_ACCESS_TOKEN=<YNAB_ACCESS_TOKEN> --env YNAB_MCP_WRITE_MODE=<YNAB_MCP_WRITE_MODE> --env YNAB_MCP_TOOL_PROFILE=<YNAB_MCP_TOOL_PROFILE> --transport stdio ynab-mcpb -- npx -y @dizzlkheinz/ynab-mcpb
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add ynab-mcpb --env YNAB_ACCESS_TOKEN=<YNAB_ACCESS_TOKEN> --env YNAB_MCP_WRITE_MODE=<YNAB_MCP_WRITE_MODE> --env YNAB_MCP_TOOL_PROFILE=<YNAB_MCP_TOOL_PROFILE> -- npx -y @dizzlkheinz/ynab-mcpb
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ynab-mcpb": {
            "command": "npx",
            "args": [
                "-y",
                "@dizzlkheinz/ynab-mcpb"
            ],
            "env": {
                "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>",
                "YNAB_MCP_WRITE_MODE": "<YNAB_MCP_WRITE_MODE>",
                "YNAB_MCP_TOOL_PROFILE": "<YNAB_MCP_TOOL_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "ynab-mcpb": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dizzlkheinz/ynab-mcpb"
            ],
            "env": {
                "YNAB_ACCESS_TOKEN": "<YNAB_ACCESS_TOKEN>",
                "YNAB_MCP_WRITE_MODE": "<YNAB_MCP_WRITE_MODE>",
                "YNAB_MCP_TOOL_PROFILE": "<YNAB_MCP_TOOL_PROFILE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e YNAB_ACCESS_TOKEN=<YNAB_ACCESS_TOKEN> -e YNAB_MCP_WRITE_MODE=<YNAB_MCP_WRITE_MODE> -e YNAB_MCP_TOOL_PROFILE=<YNAB_MCP_TOOL_PROFILE> ynab-mcpb npx -y @dizzlkheinz/ynab-mcpb
```
Вместо <…> подставьте свои значения

## Когда брать
- сверить банковский CSV с операциями YNAB
- разделить чек на отдельные позиции
- создать транзакцию по текстовому описанию
- найти расходы за период или категорию
- показать запланированные платежи и доходы

## Примеры запросов агенту
- Сверь мой расчётный счёт с файлом `bank.csv` и покажи расхождения.
- Раздели этот чек на позиции и распредели налог между ними.
- Покажи расходы на продукты за последние 30 дней и верни результат в JSON.

## Похожие
- [build-mcpb](https://affpapa.org/nevibecode/skills/build-mcpb.md) — скилл · 6229 установок
- [data-analysis](https://affpapa.org/nevibecode/skills/data-analysis.md) — скилл · 7900 установок
- [saas-metrics](https://affpapa.org/nevibecode/skills/saas-metrics.md) — скилл · 4900 установок
- [stock-correlation](https://affpapa.org/nevibecode/skills/stock-correlation.md) — скилл · 3400 установок
- [stock-liquidity](https://affpapa.org/nevibecode/skills/stock-liquidity.md) — скилл · 3100 установок
- [finance-manager](https://affpapa.org/nevibecode/skills/finance-manager.md) — скилл · 2500 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md