Skip to main content
MCP server CX Codex

Actual Budget MCP Server · agigante80 — Claude Code MCP server: install

Actual Budget MCP Server is a Claude Code MCP server for accounts, transactions, budgets and reports. It asks for approval before changing data.

MIT ★ 80 updated 2026-11-16

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> --env ACTUAL_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> --env MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> --transport stdio agigante80-actual-budget-mcp-server -- npx -y actual-mcp-server
Open on GitHub

What Actual Budget MCP Server does

Actual Budget MCP Server connects an AI assistant to Actual Budget for expense searches, budget checks and account maintenance. It can inspect spending by payee, category or month, compare actual spending with the plan, and work with transactions, rules and categories.

The stdio setup needs Node.js 22 or later, an Actual Budget server URL, a password and a Sync ID. The HTTP option runs in Docker. The Actual Budget server and Sync ID are required for the connection; write operations wait for confirmation.

What it helps with

  • find spending by payee, category or month
  • compare this month’s spending with the budget plan
  • add or correct transactions after approval
  • assign categories to uncategorised transactions
  • move money between budget categories

Example prompts for the agent

  • Show how much I spent on groceries last month, grouped by payee.
  • Which payees cost me the most this year?
  • Find uncategorised transactions that look like my usual grocery purchases and categorise them after I approve.

How to install Actual Budget MCP Server

Platform CLI

claude mcp add --env ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> --env ACTUAL_PASSWORD=<ACTUAL_PASSWORD> --env ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> --env ACTUAL_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> --env MCP_BRIDGE_DATA_DIR=<MCP_BRIDGE_DATA_DIR> --transport stdio agigante80-actual-budget-mcp-server -- npx -y actual-mcp-server

Replace <…> with your own values. 1 more environment variable is in the server README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Actual Budget MCP Server

How do I install Actual Budget MCP Server in Claude Code?

Run: `claude mcp add actual-mcp-server -e ACTUAL_SERVER_URL=<ACTUAL_SERVER_URL> -e ACTUAL_PASSWORD=<ACTUAL_PASSWORD> -e ACTUAL_BUDGET_SYNC_ID=<ACTUAL_BUDGET_SYNC_ID> -e ACTUAL_BUDGET_PASSWORD=<ACTUAL_BUDGET_PASSWORD> -- npx -y actual-mcp-server`.

What does Actual Budget MCP Server do?

It lets an AI assistant inspect Actual Budget accounts, transactions, budgets, rules and reports. The assistant can analyse spending and apply changes after confirmation.

What does Actual Budget MCP Server require?

It requires an Actual Budget server, Node.js 22 or later, the server URL, a password and a Sync ID. Docker is required for the HTTP setup.

Similar MCP servers

All MCP servers for Finance and business →

Actual Budget MCP Server by other authors comes first.

Actual Budget MCP Server s-stefanov Gives an AI assistant access to your Actual Budget data: accounts, transactions, categories and reports, all through plain-language requests. CX Codex +1 ★ 293repo stars Actual Budget henfrydls Connects Actual Budget to an MCP client for budget analysis, transaction changes, and category management. Useful when you want to work with finances in chat. CX Codex +1 ★ 20repo stars Expense Budget Tracker kirill-markin Expense Budget Tracker connects AI assistants to personal finance records over Streamable HTTP. It lets models review balances, read schemas, and record transactions using scoped permissions. CX Codex +1 ★ 43repo stars NYC Budget BetaNYC NYC Budget — an MCP server for accessing New York City budget data. It provides the agent with 14 tools to query expense funding, capital designations, and agency budgets. CX Codex +1 ★ 20repo stars event-budget Samuel Berthe event-budget builds the budget and P&L for one edition of a technical event: cost lines, revenue, reserve, cash dates and a cut order. CX Codex +1 6,800installs budget-optimizer OneWave-AI budget-optimizer — a skill that reads your spending, finds where money leaks, and builds a plan around the 50/30/20 rule, subscriptions and debt payoff. CX Codex +1 454installs budget-planner genspark-ai budget-planner turns a business plan or project spend into an Excel budget with account lines, a monthly spread, summaries and a separate assumptions sheet. CX Codex +1 ★ 12,746repo stars

Project sponsors

Companies that keep this analytics open