Actual Budget MCP Server

Package (npm 1.14.0)

npx -y [email protected]

Or add to your MCP client config:

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

• ACTUAL_SERVER_URL required — URL of your Actual Budget server
• ACTUAL_PASSWORD required secret — Actual Budget server password
• ACTUAL_BUDGET_SYNC_ID required — Budget sync ID
• ACTUAL_DATA_DIR — Local dir for cached budget data
• ACTUAL_BUDGET_ENCRYPTION_PASSWORD secret — E2E encryption password, if enabled
• ACTUAL_SYNC_TTL_MS — Sync cache TTL in ms

Package (npm 1.14.0)

Package: npm actual-mcp

• ACTUAL_SERVER_URL required — URL of your Actual Budget server
• ACTUAL_PASSWORD required secret — Actual Budget server password
• ACTUAL_BUDGET_SYNC_ID required — Budget sync ID
• ACTUAL_DATA_DIR — Local dir for cached budget data
• ACTUAL_BUDGET_ENCRYPTION_PASSWORD secret — E2E encryption password, if enabled
• ACTUAL_SYNC_TTL_MS — Sync cache TTL in ms

This server takes extra arguments — see its repository.