MCP server

Actual Budget MCP Server

io.github.s-stefanov/actual-mcp

Checked 26 Oct 2026, 08:31 UTC · Still published on its registry; checked against OSV.dev; never run by us

MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Runs on your computer

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code

Last checked

26 Oct 2026, 08:31 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.

Claude Code

claude mcp add actual-mcp --env ACTUAL_SERVER_URL=YOUR_VALUE --env ACTUAL_PASSWORD=YOUR_VALUE --env ACTUAL_BUDGET_SYNC_ID=YOUR_VALUE -- npx -y actual-mcp@1.15.1

Claude Desktop

{"mcpServers":{"actual-mcp":{"command":"npx","args":["-y","actual-mcp@1.15.1"],"env":{"ACTUAL_SERVER_URL":"YOUR_VALUE","ACTUAL_PASSWORD":"YOUR_VALUE","ACTUAL_BUDGET_SYNC_ID":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.actual-mcp]
command = "npx"
args = ["-y","actual-mcp@1.15.1"]
env = { ACTUAL_SERVER_URL = "YOUR_VALUE", ACTUAL_PASSWORD = "YOUR_VALUE", ACTUAL_BUDGET_SYNC_ID = "YOUR_VALUE" }

Gemini CLI

{"mcpServers":{"actual-mcp":{"command":"npx","args":["-y","actual-mcp@1.15.1"],"env":{"ACTUAL_SERVER_URL":"YOUR_VALUE","ACTUAL_PASSWORD":"YOUR_VALUE","ACTUAL_BUDGET_SYNC_ID":"YOUR_VALUE"}}}}

Cursor

{"mcpServers":{"actual-mcp":{"command":"npx","args":["-y","actual-mcp@1.15.1"],"env":{"ACTUAL_SERVER_URL":"YOUR_VALUE","ACTUAL_PASSWORD":"YOUR_VALUE","ACTUAL_BUDGET_SYNC_ID":"YOUR_VALUE"}}}}

VS Code

{"servers":{"actual-mcp":{"type":"stdio","command":"npx","args":["-y","actual-mcp@1.15.1"],"env":{"ACTUAL_SERVER_URL":"YOUR_VALUE","ACTUAL_PASSWORD":"YOUR_VALUE","ACTUAL_BUDGET_SYNC_ID":"YOUR_VALUE"}}}}

Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own ACTUAL_SERVER_URL, ACTUAL_PASSWORD, ACTUAL_BUDGET_SYNC_ID.

Browse

• GitHub tools
• GitHub and code hosting
• Calling other AI models

Related MCP servers

• Wedyesday — wedding planning
  Plan a wedding in chat: search vendors, get regional costs, build a checklist and budget.
• Lunenburgbudgetproject Archive
  The Lunenburg, Massachusetts town and school budget, every figure traced to its source document.
• Tenjin
  Search, read & publish paid essays. Pay-per-read in USDC on Base (x402); wallet-only, no account.
• SMI Aware Assistant
  Remote MCP server exposing SMI Aware tools, resources, and skills over Streamable HTTP.
• Run Budget Guard
  Hard dollar, token, call and time caps shared by every sub-agent in one agent run.
• Dpyc Oracle
  DPYC Social Contract community concierge — free MCP for membership, governance, and onboarding
• Usaspending
  Access US federal award, recipient, agency, and spending analytics data from USAspending.gov.
• Accrue
  Stablecoin Yield Index (SYX) and live USDC vault APYs across Ethereum, Base, Arbitrum.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.s-stefanov/actual-mcp.svg)](https://aptlynx.net/servers/io.github.s-stefanov/actual-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents