Skip to content
MCP server

session-recap

Condensed recaps of past AI coding sessions: intent, decisions, open threads

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.6.1
Listing updated
today

Similar MCP servers

About session-recap

session-recap is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Long agent transcripts are hard to return to, and this reads one in full and writes a structured recap with five sections: intent, key ideas and decisions, what changed, open threads, and where to resume. A Map view shows the phases the work went through, with pivots marked, and what shipped, stayed open or was dropped.

It reads saved sessions from Claude Code, Codex, dsh and OpenCode. Over MCP the calling agent writes the recap with its own model, so no API key is needed; a separate model is optional for the CLI and viewer. Keys, tokens and PASSWORD= style values are replaced with [REDACTED] markers before any text reaches a model, and the README notes this is pattern matching and not complete.

Besides the MCP server there is a local viewer on loopback port 4711, a CLI, and plugins for Claude Code, dsh and Codex. It needs Node.js 20 and python3.

Install

Run in a terminal

claude mcp add session-recap -- npx -y session-recap

Add to claude_desktop_config.json

{
  "mcpServers": {
    "session-recap": {
      "command": "npx",
      "args": [
        "-y",
        "session-recap"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "session-recap": {
      "command": "npx",
      "args": [
        "-y",
        "session-recap"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "session-recap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "session-recap"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "session-recap": {
      "command": "npx",
      "args": [
        "-y",
        "session-recap"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "session-recap": {
      "command": "npx",
      "args": [
        "-y",
        "session-recap"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

list_sessions
Lists sessions from every supported agent.
recap_session
Returns the recap of a session.
save_recap
Stores a recap written by the agent.

What it does

Structured recap
Five sections from intent to where to resume.
Phase map
Shows pivots, decisions with rejected options, and shipped versus dropped work.
Multi-agent reader
Reads Claude Code, Codex, dsh and OpenCode sessions.
Secret redaction
Replaces keys and credentials before any model call.
Local viewer
Browse sessions and recaps on loopback.
Output formats
Standup, handoff and PR formats are available.

Good for

  • Resume a project after weeks away
  • Write a standup note from yesterday's sessions
  • Create a handoff note for a teammate
  • Find what an old session decided and why

Pricing

Free

Free to install; an optional model key is your own

session-recap FAQ

Do I need an API key?

Not through MCP; your agent's own model writes the recap.

What leaves my machine?

A condensed transcript goes only to the model call a recap needs; the README states there is no telemetry.

Which agents are supported?

Claude Code, Codex, dsh and OpenCode.

How is it installed?

npm install -g session-recap, or run it with npx.

Is session-recap free?

Yes. session-recap is free to use.

How do I add session-recap to Claude Code?

Run this command in your terminal: claude mcp add session-recap -- npx -y session-recap

What are the best alternatives to session-recap?

The closest alternatives to session-recap are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers