Actual Budget MCP Server — MCP-сервер для Claude Code: бюджеты
Подключает Actual Budget к ИИ-ассистенту: счета, транзакции, категории и отчёты доступны через обычные запросы на естественном языке.
claude mcp add --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> --env ACTUAL_DATA_DIR=<ACTUAL_DATA_DIR> --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=<ACTUAL_BUDGET_ENCRYPTION_PASSWORD> --transport stdio actual-budget-mcp-server -- npx -y actual-mcpЧто делает Actual Budget MCP Server
Сервер отдаёт ассистенту данные вашего бюджета в Actual Budget: список счетов с балансами, историю транзакций, категории, плательщиков и правила. Отдельная группа инструментов считает аналитику — расходы по категориям, месячные итоги, сравнение плана с фактом, динамику чистого капитала, движение денег по месяцам и неделям. Пять аналитических инструментов возвращают JSON, а не markdown, чтобы суммы оставались машинночитаемыми: каждое значение — целое число центов, а в ответе есть поле amountsIn с описанием знаков.
Есть работа с сохранёнными отчётами и дашбордами: их можно создавать, менять, удалять, добавлять и двигать виджеты. Плюс два готовых промпта — financial-insights и budget-review. Для запуска нужен Node.js v16 или выше и настроенный Actual Budget; Docker Desktop опционален. Локальный запуск — git clone, затем npm install и npm run build.
Настройка идёт через переменные окружения: ACTUAL_DATA_DIR для каталога данных, ACTUAL_SERVER_URL и ACTUAL_PASSWORD для удалённого сервера, ACTUAL_BUDGET_SYNC_ID для выбора бюджета. Если сервер использует OpenID с ACTUAL_OPENID_ENFORCE=true, вход по паролю отключён, поэтому ACTUAL_PASSWORD не подойдёт — нужен ACTUAL_SESSION_TOKEN, который берётся из браузера и имеет приоритет над паролем. Токен даёт полный доступ к бюджетам, так что обращаться с ним стоит как с паролем. При недействительном или истёкшем токене сервер всё равно стартует, но вызовы инструментов падают с ошибкой аутентификации.
Какие задачи решает
- посмотреть балансы всех счетов одним запросом
- отфильтровать транзакции по дате, сумме или плательщику
- сравнить заложенный бюджет с фактическими тратами
- построить отчёт о расходах по категориям за месяц
- собрать дашборд из виджетов и переставить их местами
Примеры запросов агенту
- Покажи балансы всех моих счетов в Actual Budget
- Сравни бюджет и фактические расходы по категориям за прошлый месяц
- Добавь виджет расходов по категориям на страницу дашборда
Как установить Actual Budget MCP Server
Командой платформы
claude mcp add --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> --env ACTUAL_DATA_DIR=<ACTUAL_DATA_DIR> --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=<ACTUAL_BUDGET_ENCRYPTION_PASSWORD> --transport stdio actual-budget-mcp-server -- npx -y actual-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add actual-budget-mcp-server --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> --env ACTUAL_DATA_DIR=<ACTUAL_DATA_DIR> --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=<ACTUAL_BUDGET_ENCRYPTION_PASSWORD> -- npx -y actual-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"actual-budget-mcp-server": {
"command": "npx",
"args": [
"-y",
"actual-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>",
"ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"actual-budget-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>",
"ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> -e ACTUAL_DATA_DIR=<ACTUAL_DATA_DIR> -e ACTUAL_BUDGET_ENCRYPTION_PASSWORD=<ACTUAL_BUDGET_ENCRYPTION_PASSWORD> actual-budget-mcp-server npx -y actual-mcpВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Actual Budget MCP Server
Как установить Actual Budget MCP Server в Claude Code?
Выполните `claude mcp add actual-mcp -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> -e ACTUAL_BUDGET_ENCRYPTION_PASSWORD=<ACTUAL_BUDGET_ENCRYPTION_PASSWORD> -- npx -y actual-mcp`.
Что делает Actual Budget MCP Server?
Открывает ассистенту доступ к счетам, транзакциям, категориям, плательщикам и правилам Actual Budget, а также к аналитике: расходам по категориям, месячным итогам, чистому капиталу и движению денег.
Что нужно для работы сервера?
Node.js v16 или выше и настроенный Actual Budget. Для удалённого сервера задайте ACTUAL_SERVER_URL и ACTUAL_PASSWORD; при входе через OpenID вместо пароля используется ACTUAL_SESSION_TOKEN.
