Actual Budget MCP Server

local MCP server

Installation

Terminal

claude mcp add actual-mcp -e ACTUAL_SERVER_URL=... -e ACTUAL_PASSWORD=... -e ACTUAL_BUDGET_SYNC_ID=... -e ACTUAL_DATA_DIR=... -e ACTUAL_BUDGET_ENCRYPTION_PASSWORD=... -e ACTUAL_SYNC_TTL_MS=... -- npx -y actual-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "actual-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "...",
        "ACTUAL_PASSWORD": "...",
        "ACTUAL_BUDGET_SYNC_ID": "...",
        "ACTUAL_DATA_DIR": "...",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "...",
        "ACTUAL_SYNC_TTL_MS": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

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

Questions

Actual Budget MCP Server is a local MCP server distributed as the npm package actual-mcp.

Run: claude mcp add actual-mcp -e ACTUAL_SERVER_URL=... -e ACTUAL_PASSWORD=... -e ACTUAL_BUDGET_SYNC_ID=... -e ACTUAL_DATA_DIR=... -e ACTUAL_BUDGET_ENCRYPTION_PASSWORD=... -e ACTUAL_SYNC_TTL_MS=... -- npx -y actual-mcp

Run: codex mcp add actual-mcp --env ACTUAL_SERVER_URL=... --env ACTUAL_PASSWORD=... --env ACTUAL_BUDGET_SYNC_ID=... --env ACTUAL_DATA_DIR=... --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=... --env ACTUAL_SYNC_TTL_MS=... -- npx -y actual-mcp

Similar MCP servers

NameStars

Monarch Moneyio.github.vargahis/monarch-money14
mcp-midazio.github.codespar/mcp-midaz271
mcp-open-financeio.github.codespar/mcp-open-finance271
mcp-pluggyio.github.codespar/mcp-pluggy271
Lunch Moneyio.github.akutishevsky/lunchmoney-mcp108
revolut-mcpio.github.jeff-nasseri/revolut-mcp32
teamcityio.github.Daghis/teamcity30
Monarch MCP Serverio.github.jamiew/monarch-mcp23