Actual Budget MCP Server
Manage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
Actual Budget MCP Server scores 71 (Good), licensed MIT and written in JavaScript. It installs as a local process. It does not declare tools yet. Filed under Developer tools. GitHub shows 72 stars. Install configs are generated for 10 clients. Being listed in the registry is not the same as being vendor-official.
Good trust
71 of 100 from six public signals. Nobody can buy a point.
- Listed in the official MCP registry.
- OSI-style license: mit.
License, quality and maintenance
Where the 71 comes from
22 + 20 + 6 + 10 + 10 + 3 = 71. Each factor is capped, so no single signal can carry a listing.
Active in the official MCP registry, plus a known vendor namespace.
Registry: 22 of 30 points.How recently the repository saw a commit or release.
Maintenance: 20 of 20 points.GitHub stars and weekly downloads, on a log scale.
Popularity: 6 of 20 points.A clear, OSI-style open-source license.
License: 10 of 10 points.Not archived, a secure install path, a pinned version.
Security: 10 of 10 points.A real summary, a README with depth, listed tools.
Docs: 3 of 10 points.Install
Pick your client, copy the config, paste it in.
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
{ "mcpServers": { "agigante80-actual-mcp-server": { "command": "npx", "args": [ "-y", "actual-mcp-server@0.27.1" ], "env": { "ACTUAL_SERVER_URL": "", "ACTUAL_PASSWORD": "YOUR_ACTUAL_PASSWORD", "ACTUAL_BUDGET_SYNC_ID": "", "ACTUAL_BUDGET_PASSWORD": "YOUR_ACTUAL_BUDGET_PASSWORD", "MCP_BRIDGE_DATA_DIR": "" } } }}
Environment variables
| Name | Required | Notes |
|---|---|---|
ACTUAL_SERVER_URL | Required | URL of the Actual Budget server, for example https://actual.example.com |
ACTUAL_PASSWORDSecret | Required | Actual Budget server login password |
ACTUAL_BUDGET_SYNC_ID | Required | Sync ID of the budget (Actual: Settings, Advanced settings) |
ACTUAL_BUDGET_PASSWORDSecret | Optional | End-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL |
MCP_BRIDGE_DATA_DIR | Optional | Absolute path of a user-private directory for the local budget cache |
ACTUAL_SERVER_URL | Required | URL of the Actual Budget server; must be reachable from inside the container |
ACTUAL_PASSWORDSecret | Required | Actual Budget server login password |
ACTUAL_BUDGET_SYNC_ID | Required | Sync ID of the budget (Actual: Settings, Advanced settings) |
ACTUAL_BUDGET_PASSWORDSecret | Optional | End-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL |
MCP_SSE_AUTHORIZATIONSecret | Required | Bearer token clients must send: raw token, no Bearer prefix; generate with openssl rand -hex 32 |
Tools
All capabilitiesTools show up when the registry metadata or the repository README lists them. Public READMEs are read directly. A GitHub token is used only when one is already configured.
About
Manage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
Frequently asked questions
What is Actual Budget MCP Server?
Manage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
How do I install Actual Budget MCP Server in Claude Desktop, Cursor, or VS Code?
Pick your client in the Install section on this page and copy the generated config into the client's config file. Step-by-step guides: Claude Desktop, Cursor, and VS Code. Actual Budget MCP Server runs locally from the npm package actual-mcp-server with the command npx -y actual-mcp-server@0.27.1.
Is Actual Budget MCP Server free and open source?
Yes. Actual Budget MCP Server is released under the MIT license, an OSI-approved open-source license, so you can use, modify, and self-host it under those terms.
How is Actual Budget MCP Server's trust score calculated?
Actual Budget MCP Server scores 71 out of 100 (Good). The score adds six capped public signals: registry status, maintenance, popularity, license, documentation, and security. Nobody can pay for points. Read the methodology for the full formula.
Reviews
No reviews yet—Be the first to review
No published reviews yet. Used it? Tell the next person how it went.
Sign inA verified email is required to review this server.
Add badge to your README
Paste either snippet into the repository README. The image links to this listing.
