Actual Budget MCP Server
MCP-сервер к Actual Budget: агент читает счета и транзакции, строит отчеты по расходам и по флагу правит категории и правила.
- 279 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- С флагом `--enable-write` агент меняет и удаляет данные бюджета, а ключи и пароль сервера лежат в конфигурации клиента.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/actual-budget-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- С флагом `--enable-write` агент меняет и удаляет данные бюджета, а ключи и пароль сервера лежат в конфигурации клиента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Actual Budget MCP Server связывает личный бюджет в Actual Budget с Claude и другими MCP-клиентами. Читающие инструменты отдают счета, транзакции, историю баланса и отчеты: расходы по категориям, месячную сводку, бюджет против факта, чистый капитал, денежный поток. Есть готовые подсказки `financial-insights` и `budget-review`. При запуске с флагом `--enable-write` включаются инструменты записи: создание и правка транзакций, категорий, получателей, правил, а также сохраненных отчетов и виджетов дашборда. Сервер работает по stdio, а флаг `--sse` открывает HTTP-доступ, который при публикации в сеть закрывают токеном через `--enable-bearer`.
Для кого. Тем, кто ведет личные финансы в Actual Budget и хочет задавать агенту вопросы о расходах человеческим языком.
Подходит, если
- Нужно понять, на что ушли деньги за прошлый месяц, не собирая отчет вручную.
- Категории и получателей накопилось с дублями, и их надо слить через `merge-payees`.
- Чистый капитал нужно сопоставить по месяцам за год.
- Раскладку виджетов дашборда проще поручить агенту, чем двигать мышью.
Не подходит, если
- Бюджет ведется не в Actual Budget: сервер работает только с ним.
- Нужны реальные платежи или переводы денег: сервер правит только записи бюджета.
- Сервер с данными нельзя оставить без токена и открыть в публичную сеть.
Пример запроса к агенту
Покажи расходы по категориям за прошлый месяц и сравни их с запланированным бюджетом.MCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
`ACTUAL_SERVER_URL`- Адрес сервера Actual, если бюджет лежит на удаленном сервере
`ACTUAL_PASSWORD`секрет- Пароль сервера Actual
`ACTUAL_BUDGET_SYNC_ID`- Идентификатор нужного бюджета
`ACTUAL_DATA_DIR`- Каталог данных Actual, по умолчанию `~/.actual`
`ACTUAL_SESSION_TOKEN`секрет- Токен сессии для серверов с входом через OpenID; приоритетнее пароля
`ACTUAL_BUDGET_ENCRYPTION_PASSWORD`секрет- Отдельный пароль шифрования бюджета, если он отличается от пароля сервера
`ACTUAL_SYNC_TTL_MS`- Срок свежести данных в мс, по умолчанию 60000
`BEARER_TOKEN`секрет- Токен для режима `--enable-bearer` при открытом HTTP-доступе
Ограничения
Нужен установленный и настроенный Actual Budget, Node.js 16 или новее. Без `--enable-write` инструменты записи недоступны, а с ним агент может менять и удалять транзакции, категории и правила, поэтому делайте резервную копию бюджета. При входе через OpenID пароль не работает, нужен токен сессии из DevTools браузера, он живет ограниченное время. Суммы в JSON-отчетах идут в центах. Будущие операции в балансах не учитываются.
Как отключить. Уберите блок `actualBudget` из конфигурации клиента и перезапустите его. Чтобы оставить только чтение, запускайте сервер без `--enable-write`. Остановите Docker-контейнер, если запускали HTTP-режим.
Частые вопросы
Как включить запись?
Добавьте флаг `--enable-write` в аргументы запуска. Без него доступны только читающие инструменты.
Какие отчеты есть?
`spending-by-category`, `monthly-summary`, `budget-vs-actual`, `net-worth`, `category-trends`, `spending-by-payee` и `cash-flow`. Суммы возвращаются целыми центами.
Как открыть сервер по HTTP?
Запустите с `--sse`, а при доступе из интернета добавьте `--enable-bearer` и переменную `BEARER_TOKEN`.
Как проверить подключение к Actual?
Выполните `node build/index.js --test-resources`. Команда сообщит, видит ли сервер данные бюджета.
Нужен ли Actual Budget на сервере?
Нет, достаточно локального каталога данных `ACTUAL_DATA_DIR`. Для удаленного сервера задают `ACTUAL_SERVER_URL` и пароль.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер сервиса RiseUp: бюджет, транзакции, балансы счетов и ипотека только для чтения в Claude Desktop
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
Учет инвестиций и расходов с встроенным MCP-сервером: агент читает портфель, а записи делает через черновики
MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
Коротко о README
Инструменты, установка через Docker или npx, настройка Claude Desktop и Codex CLI, режим SSE и пакет в официальном реестре MCP.