Actual Budget MCP Server: Install & Setup

Install Actual Budget in Claude Code

npm

Claude Code

claude mcp add actual-budget -e ACTUAL_SERVER_URL=... -e ACTUAL_BUDGET_ID=... -- npx -y actual-budget-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "...",
        "ACTUAL_BUDGET_ID": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add actual-budget -e ACTUAL_SERVER_URL=... -e ACTUAL_BUDGET_ID=... -- docker run -i --rm -e ACTUAL_SERVER_URL -e ACTUAL_BUDGET_ID ghcr.io/henfrydls/actual-budget-mcp:0.11.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "actual-budget": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ACTUAL_SERVER_URL",
        "-e",
        "ACTUAL_BUDGET_ID",
        "ghcr.io/henfrydls/actual-budget-mcp:0.11.0"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "...",
        "ACTUAL_BUDGET_ID": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Actual Budget MCP server do?

Self-hosted Actual Budget analysis: spending breakdowns, category trends, projections and budget vs. actual, with guarded writes and an optional read-only mode.

Is the Actual Budget MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does Actual Budget run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Actual Budget to Claude Code?

Run: claude mcp add actual-budget -e ACTUAL_SERVER_URL=... -e ACTUAL_BUDGET_ID=... -- npx -y actual-budget-mcp

More finance, fintech & payments MCP servers

View all

AlgoVault

102.7k

AlgoVaultLabs/crypto-quant-signal-mcp

The Brain Layer for AI Trading Agents — quant calls + cross-venue arb across perp venues via MCP.

Local + RemoteFree

Alpha Vantage

104

berlinbra/alpha-vantage-mcp

Fetch stock and crypto data from the Alpha Vantage API.

LocalAccount neededPython

CoinCap

QuantGeekDev/coincap-mcp

A MCP server that provides real-time cryptocurrency market data through CoinCap's public API without requiring authentication

LocalAccount neededTypeScript

Lifeos

108

edrisranjbar/lifeos

Self-hosted life OS: habits, goals, tasks, finances and notes over a token-protected API.

LocalAccount needed

Banco Central do Brasil (BCB)

102.4k

SidneyBissoli/bcb-br-mcp

Brazilian Central Bank (BCB) economic time series via the SGS public API: Selic, IPCA, exchange rates, GDP and curated indicators.

Local + RemoteAccount neededTypeScript

LunchMoney

112

akutishevsky/lunchmoney-mcp

MCP server for LunchMoney personal finance and budgeting tool.

LocalAccount needed