Skip to content
MCP server

Crunch Accounting (crunch-mcp)

Ask about Crunch Accounting expenses, invoices, clients and banking from your assistant

Runs locallyStatus and history
Install
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.0

Add 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.Required
  • CRUNCH_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)

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government