English Français العربية

ResumeState

Official registry Productivity

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/Resume-State/resumestate-mcp/releases/download/v1.0.0/resumestate-mcp-1.0.0.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ResumeState MCP server
  2. Tools
  3. Install
  4. How the connection works
  5. Pricing
  6. Privacy
  7. Licence

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

ToolWhat it does
connectLinks this assistant to your ResumeState account with a short approval code (OAuth 2.0 device flow, RFC 8628)
resumeFetches a lane's latest handoff, or the account-wide packet and its lanes
list_lanesLists your lanes (code, name, last handoff, freshness)
handoffRecords one structured handoff under a lane: tried, decided, done, failed, state, pointer
list_artifacts, get_artifactShows artifact cards first, and full content only when it's needed
replay_search, replay_getFinds routines that worked, from the replay pool
log_session, ingest, statusSession 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:

PlanMonthlyYearly (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.

Frequently asked questions

What is ResumeState?

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

How do I install ResumeState?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does ResumeState need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is ResumeState open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains ResumeState?

It is published by Resume-State. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.