# Crunch Accounting (crunch-mcp)

> Crunch Accounting (crunch-mcp) is an open-source MCP server for finance and payments. Ask about Crunch Accounting expenses, invoices, clients and banking from your assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, macOS, Windows, Linux, CLI
- **Website:** https://crunch-mcp.mattoddie.dev
- **Repository:** https://github.com/mattoddie/crunch-mcp
- **MCP Registry name:** io.github.mattoddie/crunch-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/crunch-accounting-crunch-mcp
