ResumeState

ResumeState MCP server

Session continuity for AI assistants: resume any work lane where the last session stopped.

ResumeState keeps track of where your work stands: what was tried, what was decided, what's done and what failed. It files that under named lanes, one per line of work, so the next session can pick up where the last one stopped, on any model or vendor. This MCP server gives an assistant the tools to do that.

Tools

Install

You need Python 3.10+ and uv. Nothing to clone.

Claude Desktop (one-click bundle)

Download resumestate-mcp-1.0.0.mcpb from the latest release and open it in Claude Desktop to install it.

Claude Code

claude mcp add resumestate -- uvx --from git+https://github.com/Resume-State/resumestate-mcp resumestate-mcp

Claude Desktop, Cursor and other MCP clients (claude_desktop_config.json, .cursor/mcp.json, ...)

{
  "mcpServers": {
    "resumestate": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Resume-State/resumestate-mcp", "resumestate-mcp"]
    }
  }
}

Then ask your assistant to run connect. It shows you a link and a short code. Approve it in your ResumeState account, and the assistant gets its own pass.

How the connection works

• No API key in your config. connect uses the OAuth 2.0 device flow: you approve the assistant on the website, and it gets a pass scoped to your continuity.
• The pass stays on your machine. It's kept in ~/.resumestate/mcp-token.json, readable by your user only, and renews itself. It's never printed.
• The pass is narrow. It can't reach your keys, billing, password or other AIs. You can see it and switch it off under Connected AIs in your account.
• No configuration needed. RESUMESTATE_API_URL defaults to https://resumestate.com; you don't need to set it.

Pricing

Connecting an AI is part of a ResumeState membership. Every plan starts with a 7-day free trial (a card is asked at checkout; cancel anytime). Prices are in Canadian dollars:

See the plans and the guide to MCP continuity servers.

Privacy

Your continuity stays private to your account, and to your team on Team. This client talks only to the ResumeState API at the address above. Read the privacy page.

Licence

MIT. See LICENSE.