Install guide · VS Code

Install Actual Budget MCP Server for VS Code

Workspace file .vscode/mcp.json uses the servers key. User settings can hold the same shape.

Add to Cursor Install in VS Code Install in VS Code Insiders

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 .vscode/mcp.json on macOS, .vscode/mcp.json on Windows, or .vscode/mcp.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.

.vscode/mcp.json

{  "servers": {    "agigante80-actual-mcp-server": {      "type": "stdio",      "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	`.vscode/mcp.json`
Windows	`.vscode/mcp.json`
Linux	`.vscode/mcp.json`