SSyncDev

Arc MCP Server

Run an Actual Budget ledger from your AI agent, with phone approvals for every change on paired machines.

Local server

What is the Arc MCP Server?

Personal finance data is the last thing most people want an agent writing to unsupervised. The Arc MCP server is built around that worry. It ships inside the arc CLI, which sits on top of an Actual Budget ledger (either one managed by arc or your own Actual server), and arc mcp exposes the same operations the command line has, one tool per command, with identical argument names and validation.

What an agent can reach

The catalogue is wide, roughly 120 operations, grouped the way a budget is organised:

  • Accounts: list, balance, create, close, reopen and reconcile against a bank figure.
  • Transactions: add, bulk import with de-duplication, split, transfer, refund and duplicate detection.
  • Categories, payees, tags, rules, schedules, budget months and savings goals.
  • Debts: cards, loans and BNPL plans with cycle state, payoff maths and an avalanche or snowball plan.
  • Statement reconciliation from a CSV or JSON bank file, plus investment portfolios and reports.

Thirteen dashboard recipes also arrive as MCP prompts (recipe-spending, recipe-budget and others), which tell an agent how to assemble an HTML dashboard from the data.

Getting connected

You need an arc account. The arc app, under Settings > AI agents, shows a one-line installer that carries your instance URL and credentials; that payload is a secret and grants full access to the budget it was made for. Self-hosted Actual servers get a free arc licence for one host, valid 30 days on the free plan and renewed automatically, and they must use HTTPS unless they sit on localhost or a private network. After installing, register arc mcp with your client. The installer adds a Claude Desktop entry by itself.

Approvals and the audit trail

Pairing a machine changes the risk picture considerably. Under the default Standard preset reads run immediately, while every write waits for Face ID approval on your phone. Over MCP a gated tool waits about 45 seconds, then returns pending_approval; the agent finishes it later with arc_agent_request_status. No tool can approve its own request. arc activity keeps a hash-chained timeline of what each named agent did.

Caveats worth knowing

The installer is macOS-first; on Linux the CLI works but the Claude Desktop step does nothing. Unpaired payload installs run every operation without asking. Managed servers sleep when idle, so the first call can take a few seconds. A remote mode (arc mcp --http) exists for web clients behind a tunnel, and anyone holding that URL and token gets read and write access. For other finance-adjacent tools, browse our other integrations, or see the full list in that category for comparable connectors.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
arc_agent_permissionsReports what the current agent may do on this machine: which reads, writes and deletes run, ask first or are refused.
arc_agent_request_statusFinishes a call that returned pending_approval, running the approved call exactly once.

How to install the Arc MCP Server

{
  "mcpServers": {
    "arc": {
      "command": "arc",
      "args": [
        "mcp"
      ]
    }
  }
}

Install the arc CLI first using the command from Settings > AI agents in the arc app. The installer normally writes this entry for you.

Configuration

VariableDescriptionRequired
ACTUAL_CUSTOM_HEADERSJSON list of reverse-proxy headers for your own Actual server, overriding the stored ones for one run.Optional
ARC_CLI_LICENSEOverrides the stored arc licence used with a self-hosted Actual server.Optional
ARC_AGENTNames the agent making calls, so approvals and permissions can be set per agent.Optional
ARC_APPROVAL_WAIT_SECONDSHow long a non-terminal CLI call waits for approval before exiting (default 90 seconds).Optional

Frequently asked questions

Yes. The installer command comes from the arc app, and even a self-hosted Actual server needs an arc licence, which is free with any arc account and tied to that one server address.