Home · Setup · Claude Code
Checklists you build once and run many times, and the dated record of each run that somebody signs. You hold a checklist as a named list of steps, optionally grouped into sections, each required or optional, and run it against a job as many times as you like. A run marks every step pass, fail or not applicable, with who marked it, on what day, and a note saying what was found, and run_sign_off puts a name and a date on it and freezes it. A run COPIES its checklist's steps when it starts and records the version it copied, so editing the checklist afterwards never changes a run already under way and deleting the checklist leaves every run readable and complete. Not applicable counts as answered and never as passed: pass plus fail plus na plus pending equals the item count, and answered plus pending equals it too, which only both hold if na sits on the answered side. A required step unanswered or failed blocks the signature; force signs anyway and the exceptions stay on the record and print on the report. No count is stored: every figure is derived on the call, and a signed-off run cannot be edited or deleted, because it is the record of what somebody put their name to.
`claude mcp add checklist` at user scope is the level that matches both the meter and the data: three checklists is a business's allowance rather than a repository's, and runs are never capped on any tier, because capping the running of a checklist would cap the only thing a checklist is for.
| You say | Tool |
|---|---|
| Make a pre-delivery vehicle check: tyre pressures, lights, load secured, weight within the plated limit. | checklist_create then checklist_item_add |
| Start a run for van BX21 KLM against WO-2026-0044. | run_start |
| Ben found the load at 3620 kilos against a plated 3500, that one fails. Can I sign it off? | run_check then run_sign_off |
On the worked pre-delivery run the steps answer pass, pass, na, pass, fail, pending: five of six answered, three pass, one fail, one not applicable, one pending. That run is not signable on two counts, a required step failed and an optional one is unanswered, and run_sign_off says both rather than only that the run is open. The contract suite asserts the snapshot rule on the raw runs.json bytes, not only through the API.
The file is .mcp.json, and the key inside it is mcpServers.
| Scope | Path |
|---|---|
| local (default) | ~/.claude.json, this project only |
| project | .mcp.json at the repository root |
| user | ~/.claude.json, every project |
If you also run Claude Desktop, the shortest path there is one click: checklist.mcpb
from the latest release opens as an extension, with no JSON and no terminal.
Claude Code reads its own config, so here it is:
From the terminal, against a built file:
claude mcp add --scope user checklist -- node /absolute/path/to/mcp-servers/servers/checklist/dist/index.js
claude mcp list # health-check it before the first prompt
# or --scope project, committed to .mcp.json for the teamThe node command above wants a built file. From a clone, once:
git clone https://github.com/theluckystrike/mcp-servers.git
cd mcp-servers && npm install
npm run build -w packages/mcp-license -w servers/checklistThat writes servers/checklist/dist/index.js, and its absolute path is the one argument
the config needs.
The npm packages are not published yet, so the form below returns a 404 today. It is here because it is what the entry becomes the day the publish lands, with nothing else changed:
claude mcp add checklist -- npx -y @theluckystrike/mcp-checklistNo restart. The entry is picked up in the next session, and `/mcp` reconnects one on demand.
Nothing is published to npm yet, so the working install paths are the ones above: the .mcpb bundle from the latest release, a clone and build, or the hosted URL.
The same server runs at https://mcp.zovo.one/mcp/checklist over MCP streamable HTTP, no install. Mint a free token with curl https://mcp.zovo.one/mcp/token, or use a Pro key. It has no filesystem, so a file comes back as a one-hour download link.
claude mcp add --transport http checklist https://mcp.zovo.one/mcp/checklist \
--header "Authorization: Bearer <token>"The `--` is load-bearing: it separates Claude Code's own options, such as --transport, --env and --scope, from the command that runs the server. And the default scope is local, private to you and to the directory you ran it in, so adding it in the wrong folder leaves the tools absent with no error at all.
Free: Three checklists, and unlimited runs of them on every tier, because capping the running of a checklist would cap the only thing a checklist is for. Up to 500 steps on a checklist on every tier. Every read, every count, the failures, the outstanding list and the run report text are free, and deleting a checklist frees its slot. Pro is $19 once, verified offline.
Local, the default, writes ~/.claude.json and is private to you and that directory. --scope project writes .mcp.json at the repository root, shared through version control. --scope user loads it everywhere.
Measured, not documented: of three fresh projects, one first prompt made zero tool calls although initialize answered in 1.05 seconds. Run claude mcp list once first: it prints Connected, and the next run used the tool.
Yes: claude mcp add --transport http checklist https://mcp.zovo.one/mcp/checklist --header "Authorization: Bearer <token>". Mint a free token at https://mcp.zovo.one/mcp/token or use a Pro key. -t and -H are the short forms.
MCP Checklist in detail · The same server in Claude Desktop and Cursor · Every server in Claude Code · Guides · Claude Code docs · Buy Pro
Work orders and job cards from chat, and why the markup goes on the unit cost