Install guide · Claude Desktop
Install Actual Budget MCP Server for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
Add to Cursor: Actual Budget MCP ServerInstall in VS Code: Actual Budget MCP ServerInstall in VS Code Insiders: Actual Budget MCP Server
Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.
Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "agigante80-actual-mcp-server": { "command": "npx", "args": [ "-y", "actual-mcp-server@0.27.1" ], "env": { "ACTUAL_SERVER_URL": "", "ACTUAL_PASSWORD": "YOUR_ACTUAL_PASSWORD", "ACTUAL_BUDGET_SYNC_ID": "", "ACTUAL_BUDGET_PASSWORD": "YOUR_ACTUAL_BUDGET_PASSWORD", "MCP_BRIDGE_DATA_DIR": "" } } }}
Where the config lives
| System | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |