Home / MCP servers / Finance & commerce / actual-budget-mcp

actual-budget-mcp

actual-budget-mcp is a MCP server by henfrydls that self-hosted Actual Budget analysis: spending breakdowns, category trends, projections and budget vs. actual, with guarded writes and an optional read-only mode.

Updated 2026-10-17

What is actual-budget-mcp?

actual-budget-mcp is a MCP server by henfrydls that self-hosted Actual Budget analysis: spending breakdowns, category trends, projections and budget vs. actual, with guarded writes and an optional read-only mode. It is listed under Finance & commerce and has 15 GitHub stars.

TypeMcp server
Authorhenfrydls
Repositoryhenfrydls/actual-budget-mcp
Popularity15 GitHub stars
CategoryFinance & commerce
SecurityLow risk (84/100)
Rank#1,475 of 4,418 MCP servers; #101 in Finance & commerce
LicenseMIT
Last commit2026-10-17
Stars this week+2
RunsLocally
LanguageTypeScript
PlatformsmacOS, Windows, Linux

Is actual-budget-mcp safe to install?

actual-budget-mcp scores 84/100 on the MCPMods security check: Low risk. Things to review: can take actions such as send, write or deploy. It passed 4 of 6 checks.

MCP server results come from listing signals: who publishes it, where your data goes and what it can do. The code itself is not scanned yet.

CheckResult
Community-built serverNote
Runs on your machine onlyPass
No credentials mentionedPass
Can take actions such as send, write or deployReview
No code executionPass
Source on GitHubPass

How do I install actual-budget-mcp?

  1. Find the launch command. The README says how the server starts (npx, uvx, docker or a remote URL) and which API keys it needs.
    https://github.com/henfrydls/actual-budget-mcp
  2. Add it to Claude Code. Replace the part after -- with the command from the README. Remote servers use --transport http with a URL.
    claude mcp add actual-budget-mcp -- <command from README>
    claude mcp add --transport http actual-budget-mcp <server-url>
  3. Check it connected. This lists your MCP servers and their status.
    claude mcp list

Or ask Claude to set it up

Paste this into Claude Code and it installs actual-budget-mcp for you:

Add the "actual-budget-mcp" MCP server from https://github.com/henfrydls/actual-budget-mcp to Claude Code. Read its README for the launch command and any API keys I need, run claude mcp add, then check that it connects.