Actual Budget MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 1 436 installs a week from npm. Last commit 26 Oct 2026.
MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.
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 -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{
"mcpServers": {
"actual-mcp": {
"command": "npx",
"args": [
"-y",
"actual-mcp"
],
"env": {
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>"
}
}
}
}[mcp_servers.actual-mcp]
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>" }{
"mcpServers": {
"actual-mcp": {
"command": "npx",
"args": [
"-y",
"actual-mcp"
],
"env": {
"ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
"ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
"ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>"
}
}
}
}{
"servers": {
"actual-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-mcp"
],
"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 your Actual Budget server), <ACTUAL_PASSWORD> (Actual Budget server password), <ACTUAL_BUDGET_SYNC_ID> (Budget sync ID).
The author’s registry entry marks them as required.
Optional settings from the registry entry, left out of the block above:
ACTUAL_DATA_DIR (Local dir for cached budget data), ACTUAL_BUDGET_ENCRYPTION_PASSWORD (E2E encryption password, if enabled), ACTUAL_SYNC_TTL_MS (Sync cache TTL in ms).
Alternatives to Actual Budget MCP Server
same job, measured the same wayManage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
Household budgeting app with AI assistant: zero-based envelopes, accounts, transactions, reports.
MCP server for Huntress — accounts, organizations, agents, incidents, and reports.
MCP server for Huntress — accounts, organizations, agents, incidents, and reports.
MCP server exposing the ATimeLogger REST API (activities, reports, types)
SimpleTicket merchant backoffice: events, ticket sales, transactions, mail and reporting.
MCP server for the Reddit Ads API. List accounts, campaigns, ads, and pull reports.
MCP server for Midaz by Lerian — self-hosted double-entry ledger: accounts, balances, transactions
Actual Budget MCP Server — questions
Answers built from our own checks of this server.