Actual Budget MCP

Name: Actual Budget MCP
Author: s-stefanov

s-stefanov

开始使用源码仓库

Accesses accounts, transactions and budgets through the Actual Budget API.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add actual-budget --env ACTUAL_SERVER_URL='<ACTUAL_SERVER_URL>' --env ACTUAL_PASSWORD='<ACTUAL_PASSWORD>' --env ACTUAL_BUDGET_SYNC_ID='<ACTUAL_BUDGET_SYNC_ID>' --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD='<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>' --env ACTUAL_DATA_DIR='<ACTUAL_DATA_DIR>' -- npx -y actual-mcp

~/.codex/config.toml

[mcp_servers.actual-budget]
command = "npx"
args = ["-y", "actual-mcp"]
env = { ACTUAL_SERVER_URL = "<ACTUAL_SERVER_URL>", ACTUAL_PASSWORD = "<ACTUAL_PASSWORD>", ACTUAL_BUDGET_SYNC_ID = "<ACTUAL_BUDGET_SYNC_ID>", ACTUAL_BUDGET_ENCRYPTION_PASSWORD = "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>", ACTUAL_DATA_DIR = "<ACTUAL_DATA_DIR>" }

# codex mcp add actual-budget --env ACTUAL_SERVER_URL='<ACTUAL_SERVER_URL>' --env ACTUAL_PASSWORD='<ACTUAL_PASSWORD>' --env ACTUAL_BUDGET_SYNC_ID='<ACTUAL_BUDGET_SYNC_ID>' --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD='<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>' --env ACTUAL_DATA_DIR='<ACTUAL_DATA_DIR>' -- npx -y actual-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
        "ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>",
        "ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "actual-budget": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
        "ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>",
        "ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
        "ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>",
        "ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
        "ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>",
        "ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "<ACTUAL_SERVER_URL>",
        "ACTUAL_PASSWORD": "<ACTUAL_PASSWORD>",
        "ACTUAL_BUDGET_SYNC_ID": "<ACTUAL_BUDGET_SYNC_ID>",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "<ACTUAL_BUDGET_ENCRYPTION_PASSWORD>",
        "ACTUAL_DATA_DIR": "<ACTUAL_DATA_DIR>"
      }
    }
  }
}

需要的环境变量

ACTUAL_SERVER_URL
ACTUAL_PASSWORD
ACTUAL_BUDGET_SYNC_ID
ACTUAL_BUDGET_ENCRYPTION_PASSWORD
ACTUAL_DATA_DIR

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐