NestDaddy

Claude Checkpoint Mcp

io.github.daniel-munoz/claude-checkpoint-mcp ยท v1.0.0

MCP server that checkpoints Claude Code session context to survive crashes and token limits

Connect Runs on your machine

Terminal
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]
claude_desktop_config.json
{
  "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>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "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>"
      }
    }
  }
}
.vscode/mcp.json
{
  "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

NameDescription
CHECKPOINT_PROJECT_ROOT
Optional
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_ID
Optional
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_IDS
Optional
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 published11 Nov 2026
Last updated11 Nov 2026
Registry nameio.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.