Skip to content
MCP server
Registry

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.

by agigante80MITJavaScript72 stars
Trust score
71Good
Trust score 71 of 100, Good

Good trust

71 of 100 from six public signals. Nobody can buy a point.

  • Listed in the official MCP registry.
  • OSI-style license: mit.
How we score trust
Scorecard

License, quality and maintenance

How grades work
Trust breakdown

Where the 71 comes from

22 + 20 + 6 + 10 + 10 + 3 = 71. Each factor is capped, so no single signal can carry a listing.

Registry22 / 30

Active in the official MCP registry, plus a known vendor namespace.

Registry: 22 of 30 points.
Maintenance20 / 20

How recently the repository saw a commit or release.

Maintenance: 20 of 20 points.
Popularity6 / 20

GitHub stars and weekly downloads, on a log scale.

Popularity: 6 of 20 points.
License10 / 10

A clear, OSI-style open-source license.

License: 10 of 10 points.
Security10 / 10

Not archived, a secure install path, a pinned version.

Security: 10 of 10 points.
Docs3 / 10

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.

~/Library/Application Support/Claude/claude_desktop_config.json
{  "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

NameRequiredNotes
ACTUAL_SERVER_URLRequiredURL of the Actual Budget server, for example https://actual.example.com
ACTUAL_PASSWORDSecretRequiredActual Budget server login password
ACTUAL_BUDGET_SYNC_IDRequiredSync ID of the budget (Actual: Settings, Advanced settings)
ACTUAL_BUDGET_PASSWORDSecretOptionalEnd-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL
MCP_BRIDGE_DATA_DIROptionalAbsolute path of a user-private directory for the local budget cache
ACTUAL_SERVER_URLRequiredURL of the Actual Budget server; must be reachable from inside the container
ACTUAL_PASSWORDSecretRequiredActual Budget server login password
ACTUAL_BUDGET_SYNC_IDRequiredSync ID of the budget (Actual: Settings, Advanced settings)
ACTUAL_BUDGET_PASSWORDSecretOptionalEnd-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL
MCP_SSE_AUTHORIZATIONSecretRequiredBearer token clients must send: raw token, no Bearer prefix; generate with openssl rand -hex 32

Tools 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

5 star0 reviews at 5 stars
4 star0 reviews at 4 stars
3 star0 reviews at 3 stars
2 star0 reviews at 2 stars
1 star0 reviews at 1 stars

No published reviews yet. Used it? Tell the next person how it went.

Add badge to your README

Paste either snippet into the repository README. The image links to this listing.

Listed on MCPpedia

Top 5 MCP servers

Daily or weekly. Confirm by email, unsubscribe any time.

How often

Manage this listing

Claim this server