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
claude mcp add ks -- npx -y @keepstateai/cliWhat 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/cliPlatform CLI
codex mcp add keepstate -- npx -y @keepstateai/cliConfig file
{
"mcpServers": {
"keepstate": {
"command": "npx",
"args": [
"-y",
"@keepstateai/cli"
]
}
}
}Config file
{
"servers": {
"keepstate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@keepstateai/cli"
]
}
}
}Platform CLI
gemini mcp add keepstate npx -y @keepstateai/cliStep 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.