Actual Budget MCP Server

by s-stefanov Your server? Claim it

local only

Actual Budget MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 884 installs a week from npm. Last commit 14 Sep 2026.

MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.

Installs per day peak 62 · avg 30 · -2% w/w

a month agotoday

884

Installs / week

npm · actual-mcp

232

Stars

27 open issues

14 Sep 2026

Last commit

0 releases in 90 days

MIT

License

TypeScript

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 Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add actual-mcp -- npx -y actual-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "actual-mcp": {
      "args": [
        "-y",
        "actual-mcp"
      ],
      "command": "npx"
    }
  }
}

~/.codex/config.toml

[mcp_servers.actual-mcp]
command = "npx"
args = ["-y", "actual-mcp"]

.cursor/mcp.json

{
  "mcpServers": {
    "actual-mcp": {
      "args": [
        "-y",
        "actual-mcp"
      ],
      "command": "npx"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "actual-mcp": {
      "args": [
        "-y",
        "actual-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: ACTUAL_SERVER_URL (URL of your Actual Budget server), ACTUAL_PASSWORD (Actual Budget server password), ACTUAL_BUDGET_SYNC_ID (Budget sync ID), 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). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Actual Budget MCP Server

same job, measured the same way

vokse

by vokse

Household budgeting app with AI assistant: zero-based envelopes, accounts, transactions, reports.

answering

Huntress

by wyre-ai

MCP server for Huntress — accounts, organizations, agents, incidents, and reports.

local only

Huntress

by wyre-technology

MCP server for Huntress — accounts, organizations, agents, incidents, and reports.

local only

Atimelogger MCP

by zaplitny

MCP server exposing the ATimeLogger REST API (activities, reports, types)

40 installs/wk local only

Reddit Ads MCP

by mkerchenski

MCP server for the Reddit Ads API. List accounts, campaigns, ads, and pull reports.

local only

MCP Midaz

by codespar

MCP server for Midaz by Lerian — self-hosted double-entry ledger: accounts, balances, transactions

17 installs/wk local only

Xero

by wyre-ai

MCP server for Xero accounting — contacts, invoices, payments, accounts, and financial reports.

local only

Xero

by wyre-technology

MCP server for Xero accounting — contacts, invoices, payments, accounts, and financial reports.

local only

Actual Budget MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Actual Budget MCP Server?

Actual Budget MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package actual-mcp was installed 884 times last week.

How do I connect Actual Budget MCP Server?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls actual-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Actual Budget MCP Server?

The npm package actual-mcp was installed 884 times in the last week. Week over week that is -2%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Actual Budget MCP Server open source?

Yes — it is published under the MIT licence, written in TypeScript, 232 stars on GitHub and 27 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.