Actual Budget MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 1 648 installs a week from npm. Last commit 31 Oct 2026.
Manage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
Nothing serious here today
Today is the operative word: we check Actual Budget MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
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>' -- npx -y actual-mcp-server{
"mcpServers": {
"actual-mcp-server": {
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>"
}
}
}
}[mcp_servers.actual-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>" }{
"mcpServers": {
"actual-mcp-server": {
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>"
}
}
}
}{
"servers": {
"actual-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>"
}
}
}
}Put your own values in place of
<ACTUAL_SERVER_URL> (URL of the Actual Budget server, for example https://actual.example.com), <ACTUAL_PASSWORD> (Actual Budget server login password), <ACTUAL_BUDGET_SYNC_ID> (Sync ID of the budget (Actual: Settings, Advanced settings)).
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
ACTUAL_BUDGET_PASSWORD (End-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL), MCP_BRIDGE_DATA_DIR (Absolute path of a user-private directory for the local budget cache).
Alternatives to Actual Budget MCP Server
same job, measured the same wayMCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.
Household budgeting app with AI assistant: zero-based envelopes, accounts, transactions, reports.
Read Tillhub products, stock, transactions, customers and retail reports from your AI assistant.
Build surveys, read responses and make reports in SurveyNinja from an AI assistant.
MCP server for Huntress — accounts, organizations, agents, incidents, and reports.
MCP server for Huntress — accounts, organizations, agents, incidents, and reports.
Build surveys, read answers and make reports in WebAsk from an AI assistant.
Manage Shipday orders, drivers, driver earnings, reports from your AI assistants.
Actual Budget MCP Server — questions
Answers built from our own checks of this server.