Actual MCP Server

What it does

Actual MCP Server provides a comprehensive bridge between MCP-compatible AI assistants and self-hosted Actual Budget instances. It allows users to manage their entire financial life using natural language, eliminating the need to manually enter data into the Actual Budget UI.

Tools

• actual_accounts_list: List all financial accounts.
• actual_transactions_create: Create new transactions, including complex splits.
• actual_transactions_search_by_month: Find transactions for a specific month using ActualQL.
• actual_budgets_setAmount: Update budget limits for specific categories.
• actual_bank_sync: Trigger synchronization with bank providers via GoCardless/SimpleFIN.
• actual_entities_search: Resolve names to UUIDs for accounts, categories, and payees.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": ["-y", "actual-mcp-server", "--stdio"],
      "env": {
        "ACTUAL_SERVER_URL": "http://localhost:5006",
        "ACTUAL_PASSWORD": "your_password",
        "ACTUAL_BUDGET_SYNC_ID": "your-sync-id",
        "MCP_BRIDGE_DATA_DIR": "/absolute/path/to/data"
      }
    }
  }
}

Supported hosts

Confirmed working with Claude Desktop, LibreChat, LobeChat, Cursor, VS Code, and Gemini CLI.