How it works

Your agent does the books. The ledger keeps it honest.

LedgerMCP has three parts: the AI you already use, an MCP server that gives it the bookkeeping tools, and a double-entry ledger that enforces the accounting rules. Here is how they fit together.

Your agent, any chat

Set up books for my LLC and import this statement.
Books created with a standard small-business chart. Imported 62 transactions, categorized 59, flagged 3 for review. Want me to reconcile against the statement balance?

The three parts

Your agent

Claude, ChatGPT, Grok, or any MCP client. You talk to it in plain language: “import this statement,” “what did I spend on software?” It plans the work and calls the tools.

Bring the AI you already pay for, or use the optional built-in assistant on Growth and Scale.

The MCP server

One URL, ledgermcp.com/mcp, exposes the whole job as 72 tools: 27 that read, 45 that write. Import, categorize, split, transfer, reconcile, tag, report.

The docs are generated from the same tool list, so what your AI sees never drifts from what the server does.

The ledger

Real double-entry books in a database that won’t let them break: every entry has to balance, nothing can be quietly edited or deleted, and the same thing can’t post twice.
How, exactly →

Four ways to connect

1

Claude

In Claude: Settings → Connectors → +, then search for LedgerMCP and click Connect. It is in Claude’s connector directory, so there is no URL to paste.

Sign in with an email and a 6-digit code and Claude has the full toolset. Works on claude.ai, Desktop, and mobile.

Full Claude walkthrough →
2

ChatGPT

In ChatGPT: Settings → Connectors → Advanced → developer mode, then Create and enter https://ledgermcp.com/mcp. OAuth sign-in, no keys to paste. Available on Plus, Pro, Business, Enterprise, and Edu plans.
Full ChatGPT walkthrough →
3

Grok

In Grok: grok.com/connectors → New Connector → Custom, then paste https://ledgermcp.com/mcp as the server URL and sign in when prompted. Grok discovers the whole toolset from the server, same as every other client.
Full Grok walkthrough →
4

API key

For Claude Code, desktop agents, and scripts: mint a key in Settings → Your AI and send it as a bearer token. One key covers every book in your account.
MCP server details →

Any other MCP client needs only this config.

Connect your agent
{
  "mcpServers": {
    "ledgermcp": {
      "type": "http",
      "url": "https://ledgermcp.com/mcp",
      "headers": { "Authorization": "Bearer lmcp_YOUR_KEY" }
    }
  }
}

A month in the life of your books

  1. 1

    Statements arrive

    Bank feeds pull transactions in automatically (free for 14 days, then paid), or you hand your agent a CSV or PDF statement (free). Either way, rows land in a review queue. Nothing posts to the ledger by itself.

  2. 2

    Your agent does the work

    It categorizes against your chart of accounts, splits mixed charges, matches transfers so nothing double-counts, flags likely duplicates, and tags vendors as it goes. Anything ambiguous is left flagged for you.

  3. 3

    You review and close

    Skim the review queue in the web app or ask the agent what it was unsure about. Then close: reconcile against the statement balance, book depreciation, and lock the period so nothing can post into a closed month.

When something goes wrong

The agent miscategorized

Tell it (“that Costco charge was inventory, not meals”) and it corrects the charge. Or fix it yourself in the app with one click. Either way the correction is a linked reversal, and the merchant is remembered for next time.

Something looks off

Open Settings → Activity. Everything your AI did is there: which key, which tool, what it changed. One click reverses any of it. You can always see exactly what happened.

You want a tighter leash

Issue a read-only key: the agent can answer questions and run reports but can’t write a thing. Or skip keys entirely and work only through the web app. The books are identical either way.

Common questions

Do I have to use an AI agent?

No. The web app is a complete bookkeeping tool on its own: transaction register with inline categorization, journal, reconciliation, receipts, tags, and every report. The agent just automates the same books.

What does the AI actually control?

Only what the tools allow. It cannot edit or delete anything already in the books, and anything irreversible stays with you in the web app.

Can I start mid-year with months of backlog?

Yes, catch-up is one of the best uses. Hand your AI the statements month by month. Bulk import and bulk categorize were made for it, and one bad row never blocks the rest. Most backlogs clear in an afternoon.

What happens to my books if I stop paying?

Nothing. Paid plans cover bank feeds and the built-in assistant, so if a plan lapses those pause. Your books, reports and your AI’s access keep working, and you can export everything to CSV at any time.

See it with your own statement

Hand your agent one month of transactions and read the audit log after.