Actual Budget — MCP-сервер для Claude Code: функции и установка
Подключает Actual Budget к ИИ-клиенту: помогает анализировать бюджет, управлять транзакциями и категориями. Пригодится для работы с бюджетом через чат.
claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_SESSION_TOKEN=<ACTUAL_SESSION_TOKEN> -e ACTUAL_BUDGET_ID=<ACTUAL_BUDGET_ID> -e ACTUAL_ENCRYPTION_PASSWORD=<ACTUAL_ENCRYPTION_PASSWORD> -- npx -y actual-budget-mcpЧто делает Actual Budget
MCP-сервер подключает Actual Budget к Claude Code и другим MCP-клиентам. Он отвечает на вопросы о расходах, строит прогнозы, сравнивает бюджет с фактическими тратами и сводит данные по месяцам. Можно создавать и редактировать транзакции, переводы, категории, получателей платежей и правила.
Сервер принимает названия вместо ID и предлагает варианты при неоднозначности. Для операций удаления сначала показывает предварительный результат и ждёт подтверждения; режим ACTUAL_READ_ONLY=1 скрывает инструменты записи. Поддерживаются разборы в нескольких валютах и восстановление синхронизации через repair_sync. Перед установкой нужен запущенный сервер Actual Budget, а для Claude Code — Node.js 22.14 или новее.
Какие задачи решает
- узнать, куда ушли деньги за месяц
- сравнить план бюджета с фактическими расходами
- добавить расход или перевод через чат
- управлять категориями, получателями и правилами
- восстановить локальное состояние синхронизации
Примеры запросов агенту
- Покажи, сколько я потратил на еду в этом месяце, и сравни сумму с бюджетом.
- Добавь расход в Actual Budget и проверь, нет ли дубликата.
- Покажи категории и правила, которые сейчас настроены в моём бюджете.
Как установить Actual Budget
Командой платформы
claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_SESSION_TOKEN=<ACTUAL_SESSION_TOKEN> -e ACTUAL_BUDGET_ID=<ACTUAL_BUDGET_ID> -e ACTUAL_ENCRYPTION_PASSWORD=<ACTUAL_ENCRYPTION_PASSWORD> -- npx -y actual-budget-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add actual-budget --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_SESSION_TOKEN=<ACTUAL_SESSION_TOKEN> --env ACTUAL_BUDGET_ID=<ACTUAL_BUDGET_ID> --env ACTUAL_ENCRYPTION_PASSWORD=<ACTUAL_ENCRYPTION_PASSWORD> -- npx -y actual-budget-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SESSION_TOKEN": "<ACTUAL_SESSION_TOKEN>",
"ACTUAL_BUDGET_ID": "<ACTUAL_BUDGET_ID>",
"ACTUAL_ENCRYPTION_PASSWORD": "<ACTUAL_ENCRYPTION_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"actual-budget": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SESSION_TOKEN": "<ACTUAL_SESSION_TOKEN>",
"ACTUAL_BUDGET_ID": "<ACTUAL_BUDGET_ID>",
"ACTUAL_ENCRYPTION_PASSWORD": "<ACTUAL_ENCRYPTION_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_SESSION_TOKEN=<ACTUAL_SESSION_TOKEN> -e ACTUAL_BUDGET_ID=<ACTUAL_BUDGET_ID> -e ACTUAL_ENCRYPTION_PASSWORD=<ACTUAL_ENCRYPTION_PASSWORD> actual-budget npx -y actual-budget-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Actual Budget
Как установить Actual Budget в Claude Code?
Выполните `claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_SESSION_TOKEN=<ACTUAL_SESSION_TOKEN> -e ACTUAL_BUDGET_ID=<ACTUAL_BUDGET_ID> -e ACTUAL_ENCRYPTION_PASSWORD=<ACTUAL_ENCRYPTION_PASSWORD> -- npx -y actual-budget-mcp`.
Что делает Actual Budget?
Он подключает бюджет к MCP-клиенту, отвечает на вопросы о тратах и позволяет изменять транзакции, категории, получателей платежей и правила.
Что нужно для работы сервера в Claude Code?
Нужен запущенный сервер Actual Budget, его URL и данные доступа: пароль, токен сессии, ID бюджета и пароль шифрования. Для этого способа также нужен Node.js 22.14 или новее.
