Crunch Accounting (crunch-mcp)

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

作者：mattoddieバージョン 0.4.1i★ –iパソコンで動く

レジストリ名io.github.mattoddie/crunch-mcp

インストール

概要

作者による説明（英語の原文）

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 会計・財務・税務
入力が必要なもの：CRUNCH_CLIENT_ID, CRUNCH_CLIENT_SECRET, CRUNCH_REFRESH_TOKEN

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： 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

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

DockerDockerのインストール

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

作者の .mcpb ファイルをダウンロード

リンク先は作者自身のファイルです。私たちが置いたり再パッケージしたりしたものではありません。ファイルを開くと、Claude Desktopがインストールします。

ターミナルでこれを実行します

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

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

MCP_TRANSPORT env
Serve MCP over stdio. The image serves HTTP by default.
CRUNCH_CLIENT_ID 必須 env
The client ID Crunch gave you when it approved your API application.
CRUNCH_CLIENT_SECRET 秘密 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 秘密 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.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント mattoddie で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

会計・財務・税務のほかのサーバーとの比較i

このカテゴリのほかの2911件のうち0%よりスターが多い
このカテゴリのほかの2911件のうち66%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2911件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Crunch Accounting (crunch-mcp)は安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：CRUNCH_CLIENT_ID, CRUNCH_CLIENT_SECRET, CRUNCH_REFRESH_TOKEN

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.4.1）がレジストリに届いたのは16 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDocker, MCPBも必要です。

代わりに使えるものは？

同じカテゴリには：Finance Toolkit, SolidInvoice, Korea Tax Calculator

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Finance Toolkit

作者：JerBouma

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

パソコンでもクラウドでも★ 5,496MIT昨日更新

インストール

SolidInvoice

作者：SolidInvoice

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

クラウドで動く★ 981MIT8 日前更新

インストール

Korea Tax Calculator

作者：UpstageAI

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

パソコンで動く★ 97MIT一昨日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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)

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

会計・財務・税務のほかのサーバーとの比較i

よくある質問

代わりの候補

Finance Toolkit

SolidInvoice

Korea Tax Calculator

作者のREADME

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