# gnucash-mcp

Lets an AI assistant read and write your GnuCash book: account overview, reconciliation, customer invoices. The file stays on your machine.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 82
- Author: ninetails-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ninetails-io/gnucash-mcp
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/gnucash-mcp

## What it does

The server runs locally against your `.gnucash` file. Nothing is synced to a cloud service, and the audit log stays put. Your assistant only sees what its tool calls hand back — balances, payees, invoices — the same figures you would see on screen.

A single call returns the whole picture: net worth over time, runway, budget pacing, who owes you money, what is overdue, which accounts still need reconciling. Three sample books ship with the repo, covering a personal ledger with freelance work, a studio in Shenzhen and a German freelancer on an SKR03 chart. Try one before pointing the server at your own data. Claude Desktop users can grab the `.mcpb` bundle, double-click it and skip the terminal entirely.

You need GnuCash installed and an assistant that speaks MCP. Coming from version 1.4, read the upgrade guide first — the first write with 1.5 is where a skipped step shows up.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- pull an account and net worth summary in one request
- dictate transactions and have them written to the book
- issue a customer invoice and track receivables
- reconcile accounts and spot unreconciled entries
- check budget pacing and cash runway

## Example prompts
- How am I doing this month in `alex-chen-morales.gnucash`?
- Record a 45 dollar lunch on the Chase Sapphire card
- Invoice this customer for 3000 dollars and show me what is overdue

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md