MCP server that checkpoints Claude Code session context to survive crashes and token limits
Connect Runs on your machine
claude mcp add claude-checkpoint-mcp -e CHECKPOINT_PROJECT_ROOT=<CHECKPOINT_PROJECT_ROOT> -e CLAUDE_CODE_SESSION_ID=<CLAUDE_CODE_SESSION_ID> -e CHECKPOINT_SESSION_IDS=<CHECKPOINT_SESSION_IDS> -- npx -y [email protected]
{
"mcpServers": {
"claude-checkpoint-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CHECKPOINT_PROJECT_ROOT": "<CHECKPOINT_PROJECT_ROOT>",
"CLAUDE_CODE_SESSION_ID": "<CLAUDE_CODE_SESSION_ID>",
"CHECKPOINT_SESSION_IDS": "<CHECKPOINT_SESSION_IDS>"
}
}
}
}
{
"mcpServers": {
"claude-checkpoint-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CHECKPOINT_PROJECT_ROOT": "<CHECKPOINT_PROJECT_ROOT>",
"CLAUDE_CODE_SESSION_ID": "<CLAUDE_CODE_SESSION_ID>",
"CHECKPOINT_SESSION_IDS": "<CHECKPOINT_SESSION_IDS>"
}
}
}
}
{
"servers": {
"claude-checkpoint-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CHECKPOINT_PROJECT_ROOT": "<CHECKPOINT_PROJECT_ROOT>",
"CLAUDE_CODE_SESSION_ID": "<CLAUDE_CODE_SESSION_ID>",
"CHECKPOINT_SESSION_IDS": "<CHECKPOINT_SESSION_IDS>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
CHECKPOINT_PROJECT_ROOTOptional | Optional. Absolute path of the default project to checkpoint, used when the client has no current project (e.g. Claude Desktop). A projectRoot argument on a tool call takes precedence. |
CLAUDE_CODE_SESSION_IDOptional | Set automatically by Claude Code; do not set it yourself. Selects the per-session checkpoint file (.claude-checkpoints/<session-id>.json). Without it the server mints a session id per conversation, or uses the shared .claude-checkpoint file with CHECKPOINT_SESSION_IDS=legacy. |
CHECKPOINT_SESSION_IDSOptional | Optional. Unset or mint: clients without a session id get their own checkpoint per conversation (the server mints an id on the first save and the agent passes it back). Set to legacy to have them share one .claude-checkpoint file, as before 1.0. No effect on Claude Code. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 11 Nov 2026 |
| Last updated | 11 Nov 2026 |
| Registry name | io.github.daniel-munoz/claude-checkpoint-mcp |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
