Actual Budget MCP Server

Actual Budget MCP Server is a local MCP server: MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants. Install it from npm as actual-mcp.

Claude CodeCodexAntigravity

commandprompt

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.

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.

• Runtime: Node.js 18+ (runs with npx) or Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: ACTUAL_SERVER_URL, ACTUAL_PASSWORD, ACTUAL_BUDGET_SYNC_ID, ACTUAL_DATA_DIR, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SYNC_TTL_MS