Actual MCP Server — Actual Budget для агента
Actual MCP Server
MCP-сервер на 85 инструментов для вашего Actual Budget: расходы, категории, правила и расписания по запросу агенту
- 76 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент создает, правит и удаляет транзакции, категории и правила в реальном бюджете
- Пароль Actual и данные расходов попадают в клиент и к провайдеру модели
Установка
- Работает в
Ручная установка
npx actual-mcp-server --httpНужны Node.js 22+ и `.env` с настройками Actual.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент создает, правит и удаляет транзакции, категории и правила в реальном бюджете
- Пароль Actual и данные расходов попадают в клиент и к провайдеру модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Actual MCP Server подключает MCP-клиенты (Claude, LibreChat, LobeChat, Cursor) к вашему Actual Budget на своем сервере. Агент отвечает на вопросы вроде «сколько ушло на продукты в прошлом месяце по получателям», добавляет транзакции и переносит суммы между категориями. 85 инструментов сгруппированы в наборы: контекст, транзакции, анализ, бюджет, правила, расписания, структура (счета, категории, получатели, теги), запрос `actual_query_run` только на чтение и администрирование (смена бюджета, импорт, экспорт, синхронизация банка). Лишние наборы отключают переменной `MCP_TOOLSETS`: для чат-клиентов с малым лимитом инструментов есть пресет `chat` из 12 инструментов. Сервер работает по stdio или по HTTP, авторизуется статическим Bearer-токеном или через OIDC, обслуживает до 15 одновременных сессий и повторяет временные ошибки Actual три раза с нарастающей паузой. Удаления и слияния не повторяются.
Для кого. Тем, кто ведет домашний бюджет в Actual Budget на своем сервере и хочет разбирать расходы и править категории фразами в чате.
Подходит, если
- Хочется спросить, куда ушли деньги за месяц, и получить разбивку по получателям
- Банковскую выписку надо загрузить и быстро разнести по категориям правилами `actual_rules_create_batch`
- Нужен общий доступ семьи к бюджету через LibreChat с отдельными правами на каждого
- Бюджет месяца требуется перераспределить: перевести 200 из «Кафе» в «Подушку безопасности»
Не подходит, если
- Бюджет ведется в YNAB или другой программе: сервер работает только с Actual Budget
- Сервер Actual старше версии 25.0.0 или Node.js ниже 22: совместимость не гарантирована
- Нужен облачный сервис без собственного хостинга: Actual нужно развернуть самому
Пример запроса к агенту
Сколько я потратил на продукты в прошлом месяце, по получателям? Добавь транзакцию на 47,50 в Whole Foods на основной счет.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
ACTUAL_SERVER_URLобязательная- Адрес сервера Actual Budget, видимый из места запуска
ACTUAL_PASSWORDобязательная, секрет- Пароль входа на сервер Actual
ACTUAL_BUDGET_SYNC_IDобязательная- Sync ID бюджета из настроек Actual
MCP_SSE_AUTHORIZATIONсекрет- Bearer-токен, который отправляют клиенты
Ограничения
Нужен работающий сервер Actual Budget 25.0.0 или новее и Node.js 22 или новее. В `ACTUAL_SERVER_URL` адрес должен быть виден из места запуска: внутри Docker `localhost` указывает на сам контейнер. Нужны пароль сервера Actual и Sync ID бюджета, для зашифрованного бюджета еще `ACTUAL_BUDGET_PASSWORD`.
Данные бюджета, которые вернут инструменты, уходят провайдеру модели вашего клиента. Без `MCP_SSE_AUTHORIZATION` HTTP-режим открыт любому клиенту в сети, поэтому в продакшене токен задают всегда. Проект независимый и не связан с Actual Budget.
Как отключить. Остановите контейнер (`docker stop actual-mcp-server-backend`) или удалите сервер из настроек клиента. Смените пароль Actual, если токен был раскрыт.
Частые вопросы
Как запустить Actual MCP Server без Docker?
Командой `npx actual-mcp-server --http` в папке с заполненным `.env`; нужен Node.js 22 или новее.
Что передавать в переменных окружения?
Обязательны `ACTUAL_SERVER_URL`, `ACTUAL_PASSWORD` и `ACTUAL_BUDGET_SYNC_ID`, а Bearer-токен клиента задает `MCP_SSE_AUTHORIZATION`.
Как сократить число инструментов для Gemini или LibreChat?
Задайте `MCP_TOOLSETS`, например пресет `chat` с 12 инструментами. Скрытый инструмент сервер отклоняет и при вызове по имени.
Куда уходят данные бюджета?
Сервер обращается только к вашему Actual и к провайдеру OIDC, но ответы инструментов попадают к модели вашего клиента.
Какие способы входа поддерживает HTTP-режим?
Статический Bearer-токен в `MCP_SSE_AUTHORIZATION` или OIDC с проверкой JWT по JWKS; доступ к бюджетам задается для каждого пользователя.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к Actual Budget: агент читает счета и транзакции, строит отчеты по расходам и по флагу правит категории и правила.
MCP-сервер к YNAB: агент читает бюджеты, счета и категории, создает и правит транзакции по личному токену, запуск через uvx.
MCP-сервер для сервиса учета личных финансов LunchMoney: транзакции, бюджеты, категории и счета доступны агенту через API v2.
Официальный MCP-сервер сервиса RiseUp: бюджет, транзакции, балансы счетов и ипотека только для чтения в Claude Desktop
Сервер дает агенту чтение ваших банковских счетов и операций через Enable Banking без инструментов отправки платежей.
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Actual MCP Server — Actual Budget для агента (эта карточка) | нет | API-ключ | 76 | |
| Actual Budget MCP Server | нет | ключ необязателен | 286 | другой сервер к тому же Actual Budget; здесь 85 инструментов, наборы и OIDC |
| YNAB MCP Server | нет | API-ключ | 100 | работает с облачным YNAB, у Actual MCP Server самохостинг |
Коротко о README
README дает быстрый старт через Docker по HTTP и через npx, таблицу наборов инструментов, переменные окружения, раздел о приватности и ссылки на руководства по клиентам, развертыванию и аутентификации.