ninetails-io/gnucash-mcp

**Free, open-source accounting software that works with the LLM.**
Talk to your GnuCash books through Claude (or any AI assistant
that supports MCP). Ask "how am I doing this month," dictate
your transactions out loud, hand over the books for the AI to
keep up while you focus on running your life or your business.
The server runs on your machine and works on your local GnuCash
file; the file and its audit log never leave it. Your AI
assistant sees what its tool calls return (balances, payees,
invoices), just as you would on screen.
**Upgrading from 1.4?** Read the upgrade guide
before your first write with 1.5.
**Install in one click:** on Claude Desktop, download the
.mcpb bundle from the
latest release,
double-click it, and you're running — no terminal, no config
files. Every other MCP client — ChatGPT/Codex, Gemini,
Antigravity, and the rest — connects with
a few lines of setup. Either way, the AI
subscription you already pay for becomes a bookkeeper that never
sends a bill.
Three realistic sample books let you try it before you commit
anything: full years of activity, mixed currencies, customers,
invoices, and budgets. The Claude Desktop bundle includes them;
from a clone, one command builds them. Walk
through one in five minutes; if it clicks, point the server at
your own book and you're done.
---
What does it look like?
This is what your AI assistant sees when it opens one of the
sample books — a complete financial dashboard in a single call:
That's not a screenshot — that's the AI's actual orientation
view. Net worth trajectory, runway, budget pacing, who owes you
money, what's overdue, what hasn't been reconciled. One call,
and your assistant has the full picture before you've even
finished saying hello.
---
Who is this for?
- **Personal finance people** who keep their books in GnuCash
and want to dictate transactions, ask their assistant where
the money's going, get reconciliation help, plan budgets.
- **Small business owners** who run their books in GnuCash and
want to issue invoices, track receivables, see vendor
spending, manage cash flow without leaving the conversation.
- **People who care that their data stays local.** No cloud
sync. No SaaS. Your .gnucash file is the system of record;
this just gives your AI a way to read and write it the way
GnuCash itself does.
You don't need to be a developer. You need:
- A computer (Mac, Windows, or Linux)
- GnuCash itself, or willingness to install it (free at
gnucash.org)
- An AI assistant that supports MCP (Claude Desktop is the
most common; Claude Code, Continue.dev, and others work too)
- 10 minutes to get the sample books running, then another 10
to point at your own
---
Try it without risking anything
The repo ships three sample personas — synthetic ledgers you can
talk to without touching your real data. The bundle carries them
fully built; from a clone, one command builds them.
Pick one, point the server at it, and start asking questions.
samples/alex-chen-morales.gnucash — Personal + freelance
A Seattle-based independent software contractor with a
single-member LLC and a spouse on a hospital payroll. USD-default.
111 accounts and over 2,000 transactions from 2025 to the build
date. Has a mortgage, a brokerage with VTSAX/VBTLX/AAPL/MSFT/ETH
holdings, a Solo 401(k) beside the spouse's 403(b), eight
customers invoiced in USD, EUR and CAD, a subcontractor billed
through A/P, Washington B&O tax, scheduled bills, budgets —
pretty much everything the server can do, all in one book.
samples/lin-wei.gnucash — Shenzhen software studio
A Shenzhen developer running a registered sole-proprietor studio
that builds cross-border e-commerce software, with a spouse on a
hospital payroll. CNY-default, on a native zh_CN chart. 101
accounts and about 3,000 transactions. Shenzhen tech clients
(Tencent, DJI, SF Tech and others) paying in CNY, USD/EUR clients
paying in foreign currency with
realized FX gain/loss on rate moves, domestic Chinese investments
(宁德时代 and two ETFs), a part-time employee, an HKD credit card,
a mortgage, and mixed payment rails (corporate account + Alipay +
WeChat Pay).
samples/sabine-brenner.gnucash — German freelancer, SKR03 chart
A Munich-based freelance designer. EUR-default, on a German
SKR03 chart of accounts — every account name in German. 125
accounts and about 1,900 transactions, with live VAT returns and a
company car under the 1% rule. If a feature assumes English
account names or USD, Sabine's book is where it breaks.
All three books are fictional. See