How to install Actual Budget in Claude Code
To install Actual Budget in Claude Code, run "claude mcp add actual-budget -e ACTUAL_SERVER_URL=YOUR_ACTUAL_SERVER_URL -e ACTUAL_BUDGET_ID=YOUR_ACTUAL_BUDGET_ID -- npx -y actual-budget-mcp" in your terminal, then check it with "claude mcp list". It takes about a minute.
Built from the published package · server updated 4 days ago
- 1
Run the install command
Open a terminal in your project and run:
claude mcp add actual-budget -e ACTUAL_SERVER_URL=YOUR_ACTUAL_SERVER_URL -e ACTUAL_BUDGET_ID=YOUR_ACTUAL_BUDGET_ID -- npx -y actual-budget-mcp - 2
Choose where it applies (optional)
Add --scope user to use it in every project, or --scope project to share it with your team through a .mcp.json file.
claude mcp add --scope user actual-budget -e ACTUAL_SERVER_URL=YOUR_ACTUAL_SERVER_URL -e ACTUAL_BUDGET_ID=YOUR_ACTUAL_BUDGET_ID -- npx -y actual-budget-mcp - 3
Check that it is connected
List your servers, or type /mcp inside a Claude Code session to see its status and tools.
claude mcp list
MCP servers run with your permissions. If Actual Budget needs an API key, add it under env in the config. Check its README.
Install Actual Budget in another app
Similar servers
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
Validate oh-my-posh configurations and segment snippets against the official schema.
Real-time global intelligence across conflict, markets, energy, trade, shipping and cyber. 95 tools.
Questions
Does Actual Budget work in Claude Code?
Yes. Claude Code supports mcp servers (local and remote), skills and plugins, and Actual Budget installs with the steps above.
Actual Budget does not show up in Claude Code. What now?
Restart Claude Code fully, check the JSON is valid, and make sure Node.js (for npx) is installed. See common MCP errors and fixes.
Is Actual Budget safe?
It scores 81 of 100. Review the code before you install it, and only give it the access it needs. Grades and details.
