Actual Budget MCP Server for VS Code
io.github.agigante80/actual-mcp-server
Manage Actual Budget accounts, transactions, budgets, rules and reports from an AI assistant.
client:VS Code
transport:stdio
runtime:npm
Install Actual Budget MCP Server in VS Code
.vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "actual-server-url",
"description": "ACTUAL_SERVER_URL",
"password": true
},
{
"type": "promptString",
"id": "actual-password",
"description": "ACTUAL_PASSWORD",
"password": true
},
{
"type": "promptString",
"id": "actual-budget-sync-id",
"description": "ACTUAL_BUDGET_SYNC_ID",
"password": true
},
{
"type": "promptString",
"id": "actual-budget-password",
"description": "ACTUAL_BUDGET_PASSWORD",
"password": true
},
{
"type": "promptString",
"id": "mcp-bridge-data-dir",
"description": "MCP_BRIDGE_DATA_DIR",
"password": true
}
],
"servers": {
"actual-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
],
"env": {
"ACTUAL_SERVER_URL": "${input:actual-server-url}",
"ACTUAL_PASSWORD": "${input:actual-password}",
"ACTUAL_BUDGET_SYNC_ID": "${input:actual-budget-sync-id}",
"ACTUAL_BUDGET_PASSWORD": "${input:actual-budget-password}",
"MCP_BRIDGE_DATA_DIR": "${input:mcp-bridge-data-dir}"
}
}
}
}VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs