# ResumeState

> ResumeState is an MCP server for knowledge and memory. Session continuity MCP server that records handoffs so an AI resumes where work stopped. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://resumestate.com
- **Repository:** https://github.com/resume-state/resumestate-mcp
- **MCP Registry name:** io.github.UnderGroundDev/resumestate-mcp
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-15

## About

The core concept is the lane, a named line of work. After a session the assistant writes a structured handoff to a lane (what was tried, decided, done and failed, plus current state and a pointer), and the next session, on any model or vendor, fetches it with resume instead of starting cold.

Sign-in uses the OAuth device flow: the assistant runs connect, shows a link and short code, and you approve it in your ResumeState account. The token is stored in a user-only file under your home directory, is narrow in scope and can be switched off under Connected AIs. Other tools list lanes, browse artifact cards before loading full content, and search a replay pool for routines that worked.

The client is MIT licensed and runs locally over stdio via uvx or a Claude Desktop bundle, but it talks to the ResumeState service, which requires a paid membership.

## Features

- **Named lanes:** Organises continuity by line of work so each resumes separately.
- **Structured handoffs:** Records tried, decided, done, failed, state and pointer.
- **Cross-model resume:** Lets a different model or vendor pick up the latest handoff.
- **Device-flow sign-in:** Approve the assistant in your account; no API key in config.
- **Artifact cards:** Shows summaries first and full content only on request.
- **Replay search:** Finds routines that worked in earlier sessions.

## Good for

- Continue a project in a fresh chat without re-explaining it
- Switch models mid-project and keep the context
- Hand work between teammates on the Team plan
- Look up a routine that worked before

## Install

### Claude Code (Terminal)

```sh
claude mcp add resumestate-mcp -- npx -y https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "resumestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "resumestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "resumestate-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "resumestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "resumestate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `connect`: Links the assistant to your account with an approval code.
- `resume`: Fetches a lane's latest handoff or the account-wide packet.
- `list_lanes`: Lists lanes with last handoff and freshness.
- `handoff`: Records a structured handoff under a lane.
- `list_artifacts`: Shows artifact cards.
- `get_artifact`: Gets full artifact content.
- `replay_search`: Finds routines that worked in the replay pool.
- `replay_get`: Fetches a replay routine.
- `log_session`: Logs session bookkeeping.
- `ingest`: Ingests a transcript.
- `status`: Shows connection status.

## FAQ

### What does it cost?

Plans are Solo at $9.99 CAD a month, Team at $19.99 CAD and Enterprise at $99 CAD, each with a 7-day trial.

### Do I put an API key in my config?

No. The connect tool uses OAuth device flow.

### What does it need to run?

Python 3.10 or later and uv.

### Where is the token stored?

In a user-only file under ~/.resumestate.

### Is ResumeState free?

ResumeState is a paid product with a free trial.

### How do I add ResumeState to Claude Code?

Run this command in your terminal: claude mcp add resumestate-mcp -- npx -y https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb

### What are the best alternatives to ResumeState?

The closest alternatives to ResumeState are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/resumestate
