Crunch Accounting (crunch-mcp)
Ask about Crunch Accounting expenses, invoices, clients and banking from your assistant
- Pricing
- Open source
- Platforms
- self-hosted, macOS, Windows
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
- 3 days ago
About Crunch Accounting (crunch-mcp)
Crunch Accounting (crunch-mcp) is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Aimed at UK Crunch Accounting customers, this open-source Go server wraps Crunch's public API as 70 tools in nine toolsets: 36 read, 24 write, 9 delete and 1 email. It starts read-only. Writes, deletes and emailing customers are three separate switches, and tools that are not allowed are never registered, so the assistant cannot see them.
Login uses OAuth 2.0 with PKCE and requests only the scopes your settings need. Changing an expense or invoice fetches the current record first so payments and attachments are kept, and write tools accept dry_run to preview a field-by-field diff. An optional JSON Lines audit log records changes. It ships as a distroless Docker image of about 21 MB for amd64 and arm64, plus binaries and a Claude Desktop bundle.
Install
Run in a terminal
claude mcp add crunch-mcp --env CRUNCH_CLIENT_ID='<CRUNCH_CLIENT_ID>' --env CRUNCH_CLIENT_SECRET='<CRUNCH_CLIENT_SECRET>' --env CRUNCH_REFRESH_TOKEN='<CRUNCH_REFRESH_TOKEN>' -- docker run -i --rm -e CRUNCH_CLIENT_ID -e CRUNCH_CLIENT_SECRET -e CRUNCH_REFRESH_TOKEN ghcr.io/mattoddie/crunch-mcp:0.5.0Add to claude_desktop_config.json
{
"mcpServers": {
"crunch-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CRUNCH_CLIENT_ID",
"-e",
"CRUNCH_CLIENT_SECRET",
"-e",
"CRUNCH_REFRESH_TOKEN",
"ghcr.io/mattoddie/crunch-mcp:0.5.0"
],
"env": {
"CRUNCH_CLIENT_ID": "<CRUNCH_CLIENT_ID>",
"CRUNCH_CLIENT_SECRET": "<CRUNCH_CLIENT_SECRET>",
"CRUNCH_REFRESH_TOKEN": "<CRUNCH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"crunch-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CRUNCH_CLIENT_ID",
"-e",
"CRUNCH_CLIENT_SECRET",
"-e",
"CRUNCH_REFRESH_TOKEN",
"ghcr.io/mattoddie/crunch-mcp:0.5.0"
],
"env": {
"CRUNCH_CLIENT_ID": "<CRUNCH_CLIENT_ID>",
"CRUNCH_CLIENT_SECRET": "<CRUNCH_CLIENT_SECRET>",
"CRUNCH_REFRESH_TOKEN": "<CRUNCH_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"crunch-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CRUNCH_CLIENT_ID",
"-e",
"CRUNCH_CLIENT_SECRET",
"-e",
"CRUNCH_REFRESH_TOKEN",
"ghcr.io/mattoddie/crunch-mcp:0.5.0"
],
"env": {
"CRUNCH_CLIENT_ID": "<CRUNCH_CLIENT_ID>",
"CRUNCH_CLIENT_SECRET": "<CRUNCH_CLIENT_SECRET>",
"CRUNCH_REFRESH_TOKEN": "<CRUNCH_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"crunch-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CRUNCH_CLIENT_ID",
"-e",
"CRUNCH_CLIENT_SECRET",
"-e",
"CRUNCH_REFRESH_TOKEN",
"ghcr.io/mattoddie/crunch-mcp:0.5.0"
],
"env": {
"CRUNCH_CLIENT_ID": "<CRUNCH_CLIENT_ID>",
"CRUNCH_CLIENT_SECRET": "<CRUNCH_CLIENT_SECRET>",
"CRUNCH_REFRESH_TOKEN": "<CRUNCH_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"crunch-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CRUNCH_CLIENT_ID",
"-e",
"CRUNCH_CLIENT_SECRET",
"-e",
"CRUNCH_REFRESH_TOKEN",
"ghcr.io/mattoddie/crunch-mcp:0.5.0"
],
"env": {
"CRUNCH_CLIENT_ID": "<CRUNCH_CLIENT_ID>",
"CRUNCH_CLIENT_SECRET": "<CRUNCH_CLIENT_SECRET>",
"CRUNCH_REFRESH_TOKEN": "<CRUNCH_REFRESH_TOKEN>"
}
}
}
}Configuration
MCP_TRANSPORTServe MCP over stdio. The image serves HTTP by default.CRUNCH_CLIENT_IDThe client ID Crunch gave you when it approved your API application.RequiredCRUNCH_CLIENT_SECRETOnly for confidential clients, which Crunch issues a secret. Leave empty for a public client.CRUNCH_REDIRECT_URIOnly if your API account has a redirect URI registered with Crunch. Empty means http://127.0.0.1:8976/callback.CRUNCH_REFRESH_TOKENOptional refresh token to start from instead of logging in. Don't use it anywhere else afterwards.CRUNCH_ALLOW_WRITESAllow creating and changing records, including issuing invoices. Off means read-only.CRUNCH_ALLOW_DELETESAlso allow deleting records and removing payments. Needs CRUNCH_ALLOW_WRITES.CRUNCH_ALLOW_EMAILAlso allow emailing invoices and turning on payment reminders. Needs CRUNCH_ALLOW_WRITES.CRUNCH_TOOLSETSOptional comma-separated toolsets, e.g. account,reference,expenses. Empty means all but raw (list raw by name).CRUNCH_RAW_ALLOWOptional comma-separated path prefixes the raw API tool may use, e.g. /expenses. Empty allows all.CRUNCH_RAW_READ_ONLYKeep the raw API tool to GET requests even when CRUNCH_ALLOW_WRITES is on.CRUNCH_FILES_DIROptional folder, inside the container, for receipts to attach and files to save. Mount it too. Empty turns it off.CRUNCH_AUDIT_LOGOptional audit log of every change: stderr, or a file path inside the container. Empty turns it off.
What it does
- Three-level safety
- Read-only by default, with separate switches for writes, deletes and customer emails.
- Dry-run previews
- Write tools show the request and a diff without changing the books.
- Receipts and PDFs
- Attach receipts to expenses and fetch invoice PDFs.
- Toolset selection
- Expose only the toolsets you need to keep the model's context small.
- Audit log
- Optionally record each change as a JSON line.
Good for
- List overdue invoices and draft chasers
- Record a receipt as an expense
- Find expenses with no receipt attached
- Summarise a quarter's income and spending
Pricing
Open source
MIT licence; a Crunch account and API application are required
Prices change. Check crunch-mcp.mattoddie.dev before you buy.
Crunch Accounting (crunch-mcp) FAQ
Is it read-only?
Yes by default; CRUNCH_ALLOW_WRITES turns on changes and CRUNCH_ALLOW_DELETES adds deletion.
What do I need?
A Crunch client ID from an approved API application and Docker or a release binary.
What licence is it?
MIT.
Does it need a public server?
No. It can run over stdio with docker run -i or as a long-running HTTP service with a bearer token.
Is Crunch Accounting (crunch-mcp) free?
Yes. Crunch Accounting (crunch-mcp) is open source, so you can use and self-host it for free.
How do I add Crunch Accounting (crunch-mcp) to Claude Code?
Run this command in your terminal: claude mcp add crunch-mcp --env CRUNCH_CLIENT_ID='<CRUNCH_CLIENT_ID>' --env CRUNCH_CLIENT_SECRET='<CRUNCH_CLIENT_SECRET>' --env CRUNCH_REFRESH_TOKEN='<CRUNCH_REFRESH_TOKEN>' -- docker run -i --rm -e CRUNCH_CLIENT_ID -e CRUNCH_CLIENT_SECRET -e CRUNCH_REFRESH_TOKEN ghcr.io/mattoddie/crunch-mcp:0.5.0
What are the best alternatives to Crunch Accounting (crunch-mcp)?
The closest alternatives to Crunch Accounting (crunch-mcp) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Crunch Accounting (crunch-mcp)

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government