actual-budget-mcp-es

marcoaperez/actual-budget-mcp-es
★ 0 stars TypeScript AI/LLM Updated today
MCP server for Actual Budget — LLM-ready financial assistant with correct semantics, unit conversion and real split transactions
View on GitHub → 🔍 Audit Wallet Slippage →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "actual-budget-mcp-es": {
      "command": "npx",
      "args": [
        "-y",
        "marcoaperez/actual-budget-mcp-es"
      ]
    }
  }
}

README Excerpt

**English** | [Español](README.es.md) An MCP (Model Context Protocol) server that connects LLMs — Claude Desktop and any MCP-capable client — to a self-hosted [Actual Budget](https://actualbudget.org/) instance. It is purpose-built for LLM consumption: correct financial semantics (transfers excluded from spending summaries, net worth including off-budget accounts), amounts converted server-side so the model never does cents math, compact outputs, fresh data via sync-with-TTL, and **real** split

Tools (20)

ACTUAL_DATA_DIRACTUAL_SERVER_PASSWORDACTUAL_SERVER_URLACTUAL_SYNC_IDCURRENCYENABLE_WRITELOCALEMESSAGES_LANGSYNC_TTL_SECONDSUSDcategorize_transactionscreate_schedulecreate_transactionget_accountsget_budget_averagesget_budget_monthget_categoriesget_net_worthget_schedulesget_spending_summary