AI Plugin Index
Actual Budget
CommunityMCP server by henfrydls · updated · ★ 15 · 935 downloads a week
Actual Budget, carefully: deletes preview first, and new transactions check for duplicates. Actual Budget is a community project by henfrydls, not verified by a company domain.
Install Actual Budget
Built from the published package, never by AIclaude mcp add actual-budget -e ACTUAL_SERVER_URL=YOUR_ACTUAL_SERVER_URL -e ACTUAL_BUDGET_ID=YOUR_ACTUAL_BUDGET_ID -- npx -y actual-budget-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "YOUR_ACTUAL_SERVER_URL",
"ACTUAL_BUDGET_ID": "YOUR_ACTUAL_BUDGET_ID"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "YOUR_ACTUAL_SERVER_URL",
"ACTUAL_BUDGET_ID": "YOUR_ACTUAL_BUDGET_ID"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "YOUR_ACTUAL_SERVER_URL",
"ACTUAL_BUDGET_ID": "YOUR_ACTUAL_BUDGET_ID"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add actual-budget --env ACTUAL_SERVER_URL=YOUR_ACTUAL_SERVER_URL --env ACTUAL_BUDGET_ID=YOUR_ACTUAL_BUDGET_ID -- npx -y actual-budget-mcp{
"mcpServers": {
"actual-budget": {
"command": "npx",
"args": [
"-y",
"actual-budget-mcp"
],
"env": {
"ACTUAL_SERVER_URL": "YOUR_ACTUAL_SERVER_URL",
"ACTUAL_BUDGET_ID": "YOUR_ACTUAL_BUDGET_ID"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add actual-budget npx -y actual-budget-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the actual-budget block.
Last commit 5 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
ACTUAL_Environment variable | Required | URL of your Actual Budget server, for example http://localhost:5006 |
ACTUAL_Environment variable | Required | Your budget's Sync ID, found under Settings > Show advanced settings |
ACTUAL_Environment variable, secret | Optional | Password for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN |
ACTUAL_Environment variable, secret | Optional | Session token for servers behind OIDC, which have no password. Use instead of ACTUAL_PASSWORD; if both are set, the token wins |
ACTUAL_Environment variable, secret | Optional | Only needed if your budget file is end-to-end encrypted |
ACTUAL_Environment variable | Optional | Set to 1 to hide every write tool from the model, exposing only reads and analysis |
ACTUAL_Environment variable | Optional | Set to chat to offer the 17 everyday tools instead of all 43, which is 17.0 KiB of tool descriptions instead of 39.2 KiB on every connection. Defaults to full |
ACTUAL_Environment variable | Optional | Directory for the local budget cache |
ACTUAL_Environment variable | Optional | How long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like Actual Budget? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to Actual Budget
All alternatives →
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.
Securely access and manage FHIR healthcare data stored in Medplum.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
MCP tools for interacting with Microsoft Fabric
Actual Budget: common questions
How do I 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. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Actual Budget the official server?
Actual Budget is a community project by henfrydls, not verified by a company domain.
Is Actual Budget free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Actual Budget safe to use?
It scores 81 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to Actual Budget?
Similar MCP servers: Jitsu, Oh My Posh Validator, World Monitor, mcp.
Does Actual Budget work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.