AdYour product here, seen by people installing AI tools every day Sponsor slots open: 12 of 12, from $249 a month

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. 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. 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. 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

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.