Actual Budget MCP Server · agigante80 — Claude Code MCP server: install
Actual Budget MCP Server is a Claude Code MCP server for accounts, transactions, budgets and reports. It asks for approval before changing data.
MIT ★ 80 updated 2026-11-16
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_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> --env MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> --transport stdio agigante80-actual-budget-mcp-server -- npx -y actual-mcp-serverWhat Actual Budget MCP Server does
Actual Budget MCP Server connects an AI assistant to Actual Budget for expense searches, budget checks and account maintenance. It can inspect spending by payee, category or month, compare actual spending with the plan, and work with transactions, rules and categories.
The stdio setup needs Node.js 22 or later, an Actual Budget server URL, a password and a Sync ID. The HTTP option runs in Docker. The Actual Budget server and Sync ID are required for the connection; write operations wait for confirmation.
What it helps with
- find spending by payee, category or month
- compare this month’s spending with the budget plan
- add or correct transactions after approval
- assign categories to uncategorised transactions
- move money between budget categories
Example prompts for the agent
- Show how much I spent on groceries last month, grouped by payee.
- Which payees cost me the most this year?
- Find uncategorised transactions that look like my usual grocery purchases and categorise them after I approve.
How to install Actual Budget MCP Server
Platform CLI
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_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> --env MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> --transport stdio agigante80-actual-budget-mcp-server -- npx -y actual-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add agigante80-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_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> --env MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> -- npx -y actual-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"agigante80-actual-budget-mcp-server": {
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_BUDGET_PASSWORD": "<ACTUAL_BUDGET_PASSWORD>",
"MCP_BRIDGE_DATA_DIR": "<MCP_BRIDGE_DATA_DIR>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"agigante80-actual-budget-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_BUDGET_PASSWORD": "<ACTUAL_BUDGET_PASSWORD>",
"MCP_BRIDGE_DATA_DIR": "<MCP_BRIDGE_DATA_DIR>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
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_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> -e MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> agigante80-actual-budget-mcp-server npx -y actual-mcp-serverReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Actual Budget MCP Server
How do I install Actual Budget MCP Server in Claude Code?
Run: `claude mcp add actual-mcp-server -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> -e ACTUAL_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> -- npx -y actual-mcp-server`.
What does Actual Budget MCP Server do?
It lets an AI assistant inspect Actual Budget accounts, transactions, budgets, rules and reports. The assistant can analyse spending and apply changes after confirmation.
What does Actual Budget MCP Server require?
It requires an Actual Budget server, Node.js 22 or later, the server URL, a password and a Sync ID. Docker is required for the HTTP setup.
Similar MCP servers
All MCP servers for Finance and business →Actual Budget MCP Server by other authors comes first.