# Claude Checkpoint MCP

> Claude Checkpoint MCP is an open-source MCP server for ai models and llm tooling. Save Claude Code session state locally so a crash or /clear does not lose your place. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/daniel-munoz/claude-checkpoint-mcp
- **MCP Registry name:** io.github.daniel-munoz/claude-checkpoint-mcp
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [developer tools](https://ai-powered.com/categories/developer-tools), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

Long coding sessions build up context that is expensive to rebuild: the goal, which approaches failed, which files matter and which test is still red. This server stores that working state as a small JSON file in the project, then turns it back into a resume brief of roughly 1.2 KB, a few hundred tokens, when a new session starts.

Its most useful trick is drift detection. At save time the server records a content hash for every file with uncommitted changes, together with the git branch and HEAD. On load it compares them with the working tree and flags only the files that changed since the checkpoint, so Claude re-reads those and trusts the rest of the brief. Secrets are redacted when saving, and a backup copy is kept.

Each Claude Code session gets its own checkpoint file named after its session ID, so sessions in a shared directory do not overwrite each other. Loading lists the checkpoints and asks you which to resume rather than choosing for you. Clients without a session ID, such as Claude Desktop, get one per conversation. Everything stays on your machine, and the repository is a fork of an earlier checkpoint project.

## Features

- **Per-session checkpoints:** Each Claude Code session writes its own file, so shared directories stay clean.
- **Compact resume brief:** Rebuilds goal, tasks, decisions and touched files in a short markdown summary.
- **Drift detection:** Flags only files whose content changed since the checkpoint was saved.
- **Git facts recorded:** Stores branch, HEAD and dirty files with content hashes at save time.
- **Secret redaction:** Redacts secrets when writing the checkpoint.
- **Optional session-start hook:** The Claude Code plugin nudges Claude to offer resuming at the start of a session.
- **Local only:** Nothing is sent anywhere.

## Good for

- Resume work after a terminal crash or SSH drop
- Continue after running /clear or hitting the context limit
- Avoid re-reading unchanged files at the start of a session
- Pick which of several sessions to continue

## Install

### Claude Code (Terminal)

```sh
claude mcp add claude-checkpoint-mcp -- npx -y session-checkpoint-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "claude-checkpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "session-checkpoint-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "claude-checkpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "session-checkpoint-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "claude-checkpoint-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "session-checkpoint-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "claude-checkpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "session-checkpoint-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "claude-checkpoint-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "session-checkpoint-mcp"
      ]
    }
  }
}
```

## Tools

- `save_session_checkpoint`: Write the session's working state to a small JSON file in the project.
- `load_session_checkpoint`: Turn the checkpoint file back into a compact resume brief.
- `list_session_checkpoints`: List the checkpoints in the project so you can pick which session to resume.

## FAQ

### Where are checkpoints stored?

In .claude-checkpoints/<session-id>.json inside the project, on your machine.

### Does it send data anywhere?

No. It runs entirely locally.

### How does it know what changed?

It records content hashes of uncommitted files at save time and compares them with the working tree on load.

### Does it work outside Claude Code?

Yes. Clients such as Claude Desktop get a checkpoint per conversation, using an id the server mints on first save.

### Is Claude Checkpoint MCP free?

Yes. Claude Checkpoint MCP is open source, so you can use and self-host it for free.

### How do I add Claude Checkpoint MCP to Claude Code?

Run this command in your terminal: claude mcp add claude-checkpoint-mcp -- npx -y session-checkpoint-mcp

### What are the best alternatives to Claude Checkpoint MCP?

The closest alternatives to Claude Checkpoint MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/claude-checkpoint-mcp
