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

Tool	What it does
connect	Links this assistant to your ResumeState account with a short approval code (OAuth 2.0 device flow, RFC 8628)
resume	Fetches a lane's latest handoff, or the account-wide packet and its lanes
list_lanes	Lists your lanes (code, name, last handoff, freshness)
handoff	Records one structured handoff under a lane: tried, decided, done, failed, state, pointer
list_artifacts, get_artifact	Shows artifact cards first, and full content only when it's needed
replay_search, replay_get	Finds routines that worked, from the replay pool
log_session, ingest, status	Session bookkeeping, transcript ingest, and connection status

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:

Plan	Monthly	Yearly (20% off)
Solo	$9.99 CAD	$95.88 CAD
Team	$19.99 CAD	$191.88 CAD
Enterprise	$99 CAD	$950.40 CAD

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.