SERVER

Actual Budget

Rank #3,046

io.github.henfrydls/actual-budget-mcp

Spending analysis and safe writes for Actual Budget: every delete previews and asks first.

4 versions

7 GitHub stars

by henfrydls (1 servers)View repository ↗Claim this server

First listed

Apr 3, 2026

Last publish date

Sep 17, 2026

OVERVIEW

Actual Budget is a Model Context Protocol (MCP) server published by henfrydls. It ranks #3,046 of 132,046 servers tracked on MCP Toplist, and its repository has 7 GitHub stars. Actual Budget is listed across 2 registries — Official MCP and Glama, with 4 tracked versions. It was first listed on Apr 3, 2026 and most recently updated on Sep 17, 2026.

STANDING

#3,046of 132,046 tracked serversTop 5%

Ranks ahead of 129,000 of 132,046 servers on MCP Toplist.

CONNECT

Use Actual Budget

API keyNeeds credentials

Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.

npm package

claude mcp add actual-budget-mcp -e "ACTUAL_SERVER_URL=<your ACTUAL_SERVER_URL>" -e "ACTUAL_PASSWORD=<your ACTUAL_PASSWORD>" -e "ACTUAL_SESSION_TOKEN=<your ACTUAL_SESSION_TOKEN>" -e "ACTUAL_BUDGET_ID=<your ACTUAL_BUDGET_ID>" -e "ACTUAL_ENCRYPTION_PASSWORD=<your ACTUAL_ENCRYPTION_PASSWORD>" -e "ACTUAL_READ_ONLY=<your ACTUAL_READ_ONLY>" -e "ACTUAL_DATA_DIR=<your ACTUAL_DATA_DIR>" -- npx -y actual-budget-mcp

Replace each placeholder with your own value before saving.

Docker image

claude mcp add actual-budget-mcp -e "ACTUAL_SERVER_URL=<your ACTUAL_SERVER_URL>" -e "ACTUAL_PASSWORD=<your ACTUAL_PASSWORD>" -e "ACTUAL_SESSION_TOKEN=<your ACTUAL_SESSION_TOKEN>" -e "ACTUAL_BUDGET_ID=<your ACTUAL_BUDGET_ID>" -e "ACTUAL_READ_ONLY=<your ACTUAL_READ_ONLY>" -- docker run -i --rm ghcr.io/henfrydls/actual-budget-mcp:0.9.2

Replace each placeholder with your own value before saving.

npm package

[mcp_servers.actual-budget-mcp]
command = "npx"
args = ["-y", "actual-budget-mcp"]

[mcp_servers.actual-budget-mcp.env]
ACTUAL_SERVER_URL = "<your ACTUAL_SERVER_URL>"
ACTUAL_PASSWORD = "<your ACTUAL_PASSWORD>"
ACTUAL_SESSION_TOKEN = "<your ACTUAL_SESSION_TOKEN>"
ACTUAL_BUDGET_ID = "<your ACTUAL_BUDGET_ID>"
ACTUAL_ENCRYPTION_PASSWORD = "<your ACTUAL_ENCRYPTION_PASSWORD>"
ACTUAL_READ_ONLY = "<your ACTUAL_READ_ONLY>"
ACTUAL_DATA_DIR = "<your ACTUAL_DATA_DIR>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Docker image

[mcp_servers.actual-budget-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"]

[mcp_servers.actual-budget-mcp.env]
ACTUAL_SERVER_URL = "<your ACTUAL_SERVER_URL>"
ACTUAL_PASSWORD = "<your ACTUAL_PASSWORD>"
ACTUAL_SESSION_TOKEN = "<your ACTUAL_SESSION_TOKEN>"
ACTUAL_BUDGET_ID = "<your ACTUAL_BUDGET_ID>"
ACTUAL_READ_ONLY = "<your ACTUAL_READ_ONLY>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_ENCRYPTION_PASSWORD": "<your ACTUAL_ENCRYPTION_PASSWORD>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>",
        "ACTUAL_DATA_DIR": "<your ACTUAL_DATA_DIR>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_ENCRYPTION_PASSWORD": "<your ACTUAL_ENCRYPTION_PASSWORD>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>",
        "ACTUAL_DATA_DIR": "<your ACTUAL_DATA_DIR>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

npm package

{
  "servers": {
    "actual-budget-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_ENCRYPTION_PASSWORD": "<your ACTUAL_ENCRYPTION_PASSWORD>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>",
        "ACTUAL_DATA_DIR": "<your ACTUAL_DATA_DIR>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Docker image

{
  "servers": {
    "actual-budget-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_ENCRYPTION_PASSWORD": "<your ACTUAL_ENCRYPTION_PASSWORD>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>",
        "ACTUAL_DATA_DIR": "<your ACTUAL_DATA_DIR>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

npm package

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_ENCRYPTION_PASSWORD": "<your ACTUAL_ENCRYPTION_PASSWORD>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>",
        "ACTUAL_DATA_DIR": "<your ACTUAL_DATA_DIR>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "actual-budget-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/henfrydls/actual-budget-mcp:0.9.2"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<your ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<your ACTUAL_PASSWORD>",
        "ACTUAL_SESSION_TOKEN": "<your ACTUAL_SESSION_TOKEN>",
        "ACTUAL_BUDGET_ID": "<your ACTUAL_BUDGET_ID>",
        "ACTUAL_READ_ONLY": "<your ACTUAL_READ_ONLY>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.henfrydls%2Factual-budget-mcp.svg)](https://mcptoplist.com/server/io.github.henfrydls%2Factual-budget-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.henfrydls%2Factual-budget-mcp"><img src="https://mcptoplist.com/badge/io.github.henfrydls%2Factual-budget-mcp.svg" alt="MCP Toplist: Top 5% of 132,046" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 2 registries

Glama

Official MCP

ORGANIZATION

henfrydls

Organization

henfrydls

Servers in org

Versions across org

VERSIONS

Available versions (4)

Version	Published
0.9.2	Sep 17, 2026
0.9.1	Sep 15, 2026
0.9.0	Sep 13, 2026
0.8.2	Sep 1, 2026

FAQ

Frequently asked questions

Who maintains Actual Budget?: Actual Budget is maintained by henfrydls, which publishes 1 MCP server (4 total versions) tracked on MCP Toplist.
Is Actual Budget listed on the Official MCP Registry?: Yes — Actual Budget is listed on the Official MCP Registry, alongside Glama.
How many versions does Actual Budget have?: MCP Toplist tracks 4 versions of Actual Budget, most recently published on Sep 17, 2026.
Where can I find the source code for Actual Budget?: The source code for Actual Budget is hosted at github.com/henfrydls/actual-budget-mcp.git.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers