Actual Budget

by @henfrydls · io.github.henfrydls/actual-budget-mcp

Actual Budget, carefully: deletes preview first, and new transactions check for duplicates.

Runs on your machineLocal
Category
Developer tools
Connection
Local (npm)
Tools
Shown after install
Status
Runs on your computer

Connect it to your AI

Claude Code (npm)

claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=… -e ACTUAL_BUDGET_ID=… -- npx -y actual-budget-mcp@0.11.0

Needs: ACTUAL_SERVER_URL, ACTUAL_BUDGET_ID

Claude Code (Docker)

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

Needs: ACTUAL_SERVER_URL, ACTUAL_BUDGET_ID

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp@0.11.0"
      ]
    }
  }
}

Questions

What is the Actual Budget MCP server?

Actual Budget, carefully: deletes preview first, and new transactions check for duplicates. It is made by @henfrydls and listed in the official MCP Registry as io.github.henfrydls/actual-budget-mcp. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.

How do I add Actual Budget to Claude?

In Claude Code, run: claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=… -e ACTUAL_BUDGET_ID=… -- npx -y actual-budget-mcp@0.11.0

How do I add Actual Budget to ChatGPT?

ChatGPT only connects to remote MCP servers, and Actual Budget runs on your own computer. Use it from Claude, Cursor or another app that runs local servers.

How do I add Actual Budget to Cursor?

Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "actual-budget-mcp": { "command": "npx", "args": [ "-y", "actual-budget-mcp@0.11.0" ] } } }

Does Actual Budget work right now?

It runs on your own computer, so it works once you install it. There is no remote server for us to check.

Is this your server? Get the badge for your README
chen.media/mcp badge

Markdown (GitHub README)

[![Listed on chen.media/mcp](https://chen.media/mcp/badge/github-henfrydls-actual-budget-mcp.svg)](https://chen.media/mcp/github-henfrydls-actual-budget-mcp)

HTML (switches to dark mode on its own)

<a href="https://chen.media/mcp/github-henfrydls-actual-budget-mcp"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-henfrydls-actual-budget-mcp.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-henfrydls-actual-budget-mcp.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>

More in Developer tools

See all