Skip to main content
MCP server CX Codex

KeepState — Claude Code MCP server: features and setup

This MCP server for Claude Code controls KeepState agent sessions, including starting, messaging and pausing them. It can carry over conversations from Claude Code or Codex, and summaries from Cursor.

MIT ★ 1 updated 2026-11-16

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add ks -- npx -y @keepstateai/cli
Open on GitHub

What KeepState does

KeepState manages persistent agent sessions and can bring in conversations from local coding tools. Sessions can be started, monitored, paused and resumed. Imports from Claude Code and Codex retain the conversation; a Cursor chat becomes a written summary instead.

An import starts with a plan, and execution requires confirmation. Secrets such as API keys are removed before transfer, and file uploads follow filtering rules. The server relies on KeepState’s control plane, while npx runs its CLI package. Cursor chat-store access works from a copy and is best effort.

What it helps with

  • start or pause a KeepState agent session
  • move a Claude Code or Codex conversation into a new session
  • bring a Cursor chat over as a summary
  • send a message to an agent and monitor its session

Example prompts for the agent

  • Start a KeepState agent session for this task.
  • Plan an import of my latest Claude Code session into KeepState, but don’t execute it yet.
  • Import my latest Cursor chat into KeepState as a summary.

How to install KeepState

Platform CLI

claude mcp add ks -- npx -y @keepstateai/cli

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about KeepState

How do I install KeepState in Claude Code?

Run claude mcp add ks -- npx -y @keepstateai/cli. You can also register it under keepstate with claude mcp add keepstate -- npx -y @keepstateai/cli.

What does KeepState do?

It manages KeepState agent sessions and can transfer conversations from Claude Code or Codex into a new session. Cursor chats are imported as written summaries.

What does KeepState need to run?

It needs the @keepstateai/cli package, launched with npx, and the KeepState control plane. The CLI supports browser-based sign-in.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open