Crunch Accounting (crunch-mcp)

Name: Crunch Accounting (crunch-mcp)
Author: mattoddie

von mattoddieVersion 0.4.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.mattoddie/crunch-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Work with your Crunch Accounting books: expenses, receipts, invoices, clients, suppliers and banking

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Buchhaltung, Finanzen & Steuern
Das musst du eintragen: CRUNCH_CLIENT_ID, CRUNCH_CLIENT_SECRET, CRUNCH_REFRESH_TOKEN

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: MCP_TRANSPORT, CRUNCH_CLIENT_ID, CRUNCH_CLIENT_SECRET, CRUNCH_REDIRECT_URI, CRUNCH_REFRESH_TOKEN, CRUNCH_ALLOW_WRITES, CRUNCH_ALLOW_DELETES, CRUNCH_ALLOW_EMAIL, CRUNCH_TOOLSETS, CRUNCH_FILES_DIR, CRUNCH_AUDIT_LOG

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

DockerDocker installiert

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Die .mcpb-Datei des Entwicklers herunterladen

Der Link führt zur Datei des Entwicklers selbst; wir hosten sie nicht und verpacken sie nicht neu. Öffne die Datei, dann installiert Claude Desktop sie.

Führe das in deinem Terminal aus

claude mcp add crunch --env MCP_TRANSPORT=your-value --env CRUNCH_CLIENT_ID=your-value --env CRUNCH_CLIENT_SECRET=your-value --env CRUNCH_REDIRECT_URI=your-value --env CRUNCH_REFRESH_TOKEN=your-value --env CRUNCH_ALLOW_WRITES=your-value --env CRUNCH_ALLOW_DELETES=your-value --env CRUNCH_ALLOW_EMAIL=your-value --env CRUNCH_TOOLSETS=your-value --env CRUNCH_FILES_DIR=your-value --env CRUNCH_AUDIT_LOG=your-value -- docker run -i --rm -e MCP_TRANSPORT -e CRUNCH_CLIENT_ID -e CRUNCH_CLIENT_SECRET -e CRUNCH_REDIRECT_URI -e CRUNCH_REFRESH_TOKEN -e CRUNCH_ALLOW_WRITES -e CRUNCH_ALLOW_DELETES -e CRUNCH_ALLOW_EMAIL -e CRUNCH_TOOLSETS -e CRUNCH_FILES_DIR -e CRUNCH_AUDIT_LOG ghcr.io/mattoddie/crunch-mcp:0.4.1

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "crunch": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "CRUNCH_CLIENT_ID",
        "-e",
        "CRUNCH_CLIENT_SECRET",
        "-e",
        "CRUNCH_REDIRECT_URI",
        "-e",
        "CRUNCH_REFRESH_TOKEN",
        "-e",
        "CRUNCH_ALLOW_WRITES",
        "-e",
        "CRUNCH_ALLOW_DELETES",
        "-e",
        "CRUNCH_ALLOW_EMAIL",
        "-e",
        "CRUNCH_TOOLSETS",
        "-e",
        "CRUNCH_FILES_DIR",
        "-e",
        "CRUNCH_AUDIT_LOG",
        "ghcr.io/mattoddie/crunch-mcp:0.4.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "CRUNCH_CLIENT_ID": "your-value",
        "CRUNCH_CLIENT_SECRET": "your-value",
        "CRUNCH_REDIRECT_URI": "your-value",
        "CRUNCH_REFRESH_TOKEN": "your-value",
        "CRUNCH_ALLOW_WRITES": "your-value",
        "CRUNCH_ALLOW_DELETES": "your-value",
        "CRUNCH_ALLOW_EMAIL": "your-value",
        "CRUNCH_TOOLSETS": "your-value",
        "CRUNCH_FILES_DIR": "your-value",
        "CRUNCH_AUDIT_LOG": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "crunch": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "CRUNCH_CLIENT_ID",
        "-e",
        "CRUNCH_CLIENT_SECRET",
        "-e",
        "CRUNCH_REDIRECT_URI",
        "-e",
        "CRUNCH_REFRESH_TOKEN",
        "-e",
        "CRUNCH_ALLOW_WRITES",
        "-e",
        "CRUNCH_ALLOW_DELETES",
        "-e",
        "CRUNCH_ALLOW_EMAIL",
        "-e",
        "CRUNCH_TOOLSETS",
        "-e",
        "CRUNCH_FILES_DIR",
        "-e",
        "CRUNCH_AUDIT_LOG",
        "ghcr.io/mattoddie/crunch-mcp:0.4.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "CRUNCH_CLIENT_ID": "your-value",
        "CRUNCH_CLIENT_SECRET": "your-value",
        "CRUNCH_REDIRECT_URI": "your-value",
        "CRUNCH_REFRESH_TOKEN": "your-value",
        "CRUNCH_ALLOW_WRITES": "your-value",
        "CRUNCH_ALLOW_DELETES": "your-value",
        "CRUNCH_ALLOW_EMAIL": "your-value",
        "CRUNCH_TOOLSETS": "your-value",
        "CRUNCH_FILES_DIR": "your-value",
        "CRUNCH_AUDIT_LOG": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

MCP_TRANSPORT env
Serve MCP over stdio. The image serves HTTP by default.
CRUNCH_CLIENT_ID erforderlich env
The client ID Crunch gave you when it approved your API application.
CRUNCH_CLIENT_SECRET geheim env
Only for confidential clients, which Crunch issues a secret. Leave empty for a public client.
CRUNCH_REDIRECT_URI env
Only if your API account has a redirect URI registered with Crunch. Empty means http://127.0.0.1:8976/callback.
CRUNCH_REFRESH_TOKEN geheim env
Optional refresh token to start from instead of logging in. Don't use it anywhere else afterwards.
CRUNCH_ALLOW_WRITES env
Allow creating and changing records, including issuing invoices. Off means read-only.
CRUNCH_ALLOW_DELETES env
Also allow deleting records and removing payments. Needs CRUNCH_ALLOW_WRITES.
CRUNCH_ALLOW_EMAIL env
Also allow emailing invoices and turning on payment reminders. Needs CRUNCH_ALLOW_WRITES.
CRUNCH_TOOLSETS env
Optional comma-separated toolsets to expose fewer tools, e.g. account,reference,expenses. Empty means all.
CRUNCH_FILES_DIR env
Optional folder, inside the container, for receipts to attach and files to save. Mount it too. Empty turns it off.
CRUNCH_AUDIT_LOG env
Optional audit log of every change: stderr, or a file path inside the container. Empty turns it off.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto mattoddie bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Mehr Sterne als 0 % der anderen 2898 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 67 % der anderen 2898 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 2898 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Crunch Accounting (crunch-mcp) sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: CRUNCH_CLIENT_ID, CRUNCH_CLIENT_SECRET, CRUNCH_REFRESH_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.4.1) kam vor 16 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker, MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Finance Toolkit

von JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

Computer oder Cloud★ 5.496MITAktualisiert gestern

Installieren

SolidInvoice

von SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

Läuft in der Cloud★ 981MITAktualisiert vor 8 Tagen

Installieren

Korea Tax Calculator

von UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

Läuft auf deinem Computer★ 97MITAktualisiert gestern

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

crunch-mcp

Talk to your books.

An open-source Model Context Protocol server for Crunch Accounting, the UK online accounting service. It lets Claude and other AI assistants read and, if you allow it, update your expenses, receipts, invoices, clients, suppliers and bank accounts, all from one small Docker container.

[crunch-mcp.mattoddie.dev](https://crunch-mcp.mattoddie.dev)

Quick start · Documentation · Tool reference · Contributing

"How's the business looking this month?"

*You have £18,240 across your two bank accounts and £312 on the company credit card. Three sales invoices are unpaid, £7,800 in total. INV-0042 to Example Client Ltd (£2,400) is 12 days overdue; the other two aren't due yet. On the spending side, four September expenses have no receipt attached and one bill from Example Hosting Ltd (£96) is still unpaid. Want me to draft a polite chaser for INV-0042, or list the expenses that are missing receipts?*

Ask about your business in plain English. The assistant picks from 70 tools to look things up and, if you allow it, make changes. Some examples:

🩺 *"Give me a health check of the business."*
🧾 *"Here's a receipt for a train ticket to Leeds. Record it as an expense paid from the business account."*
📬 *"Which invoices are overdue? Draft a chasing email for each customer."*
📊 *"Summarise income and spending for the last quarter, with an estimate of the VAT."*
🔍 *"Which expenses this year have no receipt attached?"*
📝 *"Invoice Example Client Ltd for 5 days of consulting at £450 a day, on 30-day terms."*

Highlights

🐳 Docker-first and tiny. One image (ghcr.io/mattoddie/crunch-mcp) for linux/amd64 and linux/arm64, about 21 MB. It's a single static Go binary on a distroless base, with no shell or package manager, running as a non-root user. It serves Streamable HTTP for a long-running service, or stdio for docker run -i. You can also run the binary on its own.
🛡️ Safe by default. The server is read-only unless you turn on writes. Deleting needs a second switch, and emailing invoices or payment reminders to customers needs a third. The switches also hold inside request bodies and the raw API tool, and the HTTP server requires a bearer token. Tools that aren't allowed aren't registered at all, and destructive tools, such as deletes and issuing an invoice, are labelled so your MCP client asks before running them.
🔑 Least-privilege login. It logs in with Crunch's own OAuth 2.0 flow (with PKCE) and asks only for the scopes your settings need. Tokens never appear in tool output.
🔄 Stays logged in. Crunch rotates refresh tokens, and reusing an old one revokes your login. crunch-mcp saves each new token before using it and never refreshes twice at once, so it keeps working across restarts.
✏️ Careful updates. Changing an expense or invoice fetches the current record and changes only what you asked, so payments and attachments are never dropped by accident.
🔍 Preview and audit. Every tool that changes something takes dry_run: true to show the request it would send, with a field-by-field diff for updates, without changing anything. CRUNCH_AUDIT_LOG records each change in a JSON Lines audit log.
🖥️ One-click Claude Desktop install. Each release has an extension bundle (.mcpb) for macOS, Windows and Linux, with a settings form and no Docker needed.
📎 Receipts and PDFs. Attach receipts and timesheets, download receipts as images the assistant can read, and fetch invoice PDFs.
🎛️ Tunable. Expose only the toolsets you need, which keeps the model's context small and focused. List tools take search, fields and limit to fetch only what's needed.
🧪 Tested. The test suite runs against a mock Crunch API and OAuth server on every build.

Quick start

Using Claude Desktop? Download the extension bundle for your computer from the latest release, open it, enter your Crunch client ID and ask Claude to *"log in to Crunch"*. See Claude Desktop. The steps below set up the Docker server for every other client.

You need Docker, a Crunch account, Crunch API access and an MCP client such as Claude Code.

1. Get API access. Apply for access to Crunch's public API through the application form linked from Crunch's developer documentation. Crunch sends you a client ID, and a client secret if you're set up as a confidential client. There's no sandbox, so a free Crunch account is a good place to try things. Getting started has the details.

2. Set up the server.

mkdir crunch-mcp && cd crunch-mcp

curl -fsSLO https://raw.githubusercontent.com/mattoddie/crunch-mcp/main/compose.yaml curl -fsSL https://raw.githubusercontent.com/mattoddie/crunch-mcp/main/example.env -o .env

Edit .env: set CRUNCH_CLIENT_ID (and CRUNCH_CLIENT_SECRET if you have one)

and a random MCP_AUTH_TOKEN, which the HTTP server requires (e.g. `openssl rand -hex 32`)

3. Log in to Crunch and start the server.

docker compose run --rm -p 127.0.0.1:8976:8976 crunch-mcp login   # open the URL it prints and click Allow

docker compose up -d

If your browser isn't on the Docker host, the page after Allow won't load. That's fine: copy the URL from the address bar and paste it into the terminal.

4. Connect your assistant.

claude mcp add --transport http crunch http://<docker-host>:8080/mcp \

--header "Authorization: Bearer "

Now ask *"How's my business doing?"* in Claude Code.

Using Claude Desktop, VS Code, Cursor or Codex? See Connecting MCP clients. Prefer not to run a service? Use stdio mode with docker run -i or the local binary.

crunch-mcp is listed in the official MCP Registry as io.github.mattoddie/crunch-mcp, so clients that install servers from the registry can set it up for you, with the Docker image in stdio mode or an extension bundle.

Turning on changes

Out of the box the assistant can look but not touch. To let it make changes, add these to .env:

CRUNCH_ALLOW_WRITES=true    # create and update expenses, invoices, clients, suppliers, payments, attachments…

CRUNCH_ALLOW_DELETES=true # also allow deleting records and removing payments (needs writes) CRUNCH_ALLOW_EMAIL=true # also allow emailing invoices and payment reminders to customers (needs writes) CRUNCH_TOOLSETS=account,reference,expenses,invoices,clients,suppliers # optional: expose fewer tools CRUNCH_AUDIT_LOG=stderr # optional: log every change (or an absolute file path; see docs/configuration.md)

The login needs matching scopes, so log in again after turning on writes or deletes:

docker compose stop

docker compose run --rm -p 127.0.0.1:8976:8976 crunch-mcp login docker compose up -d

Ask for a dry run first when it matters: *"Record that receipt, but show me a dry run first."*

Read Security before turning on writes for your real books.

What it can do

Toolset	What's covered
`account`	Login status and the OAuth login flow, the logged-in user, company details (VAT number and scheme, addresses) and a one-call business overview
`reference`	The values Crunch expects: expense types, VAT types, payment methods, countries, open accounting periods, directors and employees
`banking`	Bank accounts and credit cards: balances, details, payments recorded against them, opening balances, default accounts, archiving
`clients`	Clients (the customers you invoice): list, look up, create, update and delete
`suppliers`	Suppliers: list, look up, create, update, archive and delete
`expenses`	Expenses: list and filter, totals, create with lines, payments and receipts, update, record and remove payments, attach and download receipts, delete
`recurring`	Recurring expenses that Crunch creates on a schedule: list, create, pause or change, delete
`invoices`	Sales invoices: list and filter, totals, create drafts, update, issue, email to the customer, record and remove payments, attachments, PDF download, delete
`raw`	An escape hatch that calls any Crunch public API endpoint

See the [tool reference](docs/tools.md) for every tool and argument. Ready-made prompts like business_health_check, record_receipt and chase_overdue_invoices chain the tools together for common jobs.

Documentation

The docs are also published at [crunch-mcp.mattoddie.dev/docs](https://crunch-mcp.mattoddie.dev/docs/), with search.


🚀 Getting started	Step-by-step setup, from API access to first question
🔌 Connecting MCP clients	Claude Code, Claude Desktop, VS Code, Cursor, Codex, stdio mode
⚙️ Configuration	Every environment variable, how login and tokens work, Docker secrets, toolsets
🐳 Deployment	Compose, image tags, upgrades, TLS reverse proxy, hardening, running without Docker
💬 Using crunch-mcp	Example conversations, prompts, how changes, receipts and PDFs work
🧰 Tool reference	Every tool and prompt, generated from the code
🛡️ Security	Threat model, least privilege, token storage, safe write setups
📡 Compatibility	The Crunch API, its limits, and known gaps
🩹 Troubleshooting	Common errors and how to fix them
🛠️ Development	Architecture, adding a tool, testing

Contributing

Contributions are very welcome, whether that's bug reports, docs or new tools. Read the contributing guide to get started, and please follow the code of conduct. To report a vulnerability, see the security policy. Please don't open a public issue for one.

License

*crunch-mcp is an independent community project. It is not affiliated with, endorsed by or sponsored by Crunch (E-Crunch Ltd). "Crunch" is a trademark of E-Crunch Ltd.*

Crunch Accounting (crunch-mcp)

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Häufige Fragen

Alternativen

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README vom Entwickler

crunch-mcp

Highlights

Quick start

Edit .env: set CRUNCH_CLIENT_ID (and CRUNCH_CLIENT_SECRET if you have one)

and a random MCP_AUTH_TOKEN, which the HTTP server requires (e.g. openssl rand -hex 32)

Turning on changes

What it can do

Documentation

Contributing

License

and a random MCP_AUTH_TOKEN, which the HTTP server requires (e.g. `openssl rand -hex 32`)