Actual Budget MCP Server

Package (npm 0.25.1)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "actual-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<YOUR_VALUE>",
        "ACTUAL_PASSWORD": "<YOUR_VALUE>",
        "ACTUAL_BUDGET_SYNC_ID": "<YOUR_VALUE>",
        "ACTUAL_BUDGET_PASSWORD": "<YOUR_VALUE>",
        "MCP_BRIDGE_DATA_DIR": "<YOUR_VALUE>"
      }
    }
  }
}

• ACTUAL_SERVER_URL required — URL of the Actual Budget server, for example https://actual.example.com
• ACTUAL_PASSWORD required secret — Actual Budget server login password
• ACTUAL_BUDGET_SYNC_ID required — Sync ID of the budget (Actual: Settings, Advanced settings)
• ACTUAL_BUDGET_PASSWORD secret — End-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL
• MCP_BRIDGE_DATA_DIR — Absolute path of a user-private directory for the local budget cache

This server takes extra arguments — see its repository.

Package (oci)

Package: oci docker.io/agigante80/actual-mcp-server:0.25.1

• ACTUAL_SERVER_URL required — URL of the Actual Budget server; must be reachable from inside the container
• ACTUAL_PASSWORD required secret — Actual Budget server login password
• ACTUAL_BUDGET_SYNC_ID required — Sync ID of the budget (Actual: Settings, Advanced settings)
• ACTUAL_BUDGET_PASSWORD secret — End-to-end encryption password, for an encrypted budget only. Requires an https:// ACTUAL_SERVER_URL
• MCP_SSE_AUTHORIZATION required secret — Bearer token clients must send: raw token, no Bearer prefix; generate with openssl rand -hex 32

This server takes extra arguments — see its repository.