session-recap
Condensed recaps of past AI coding sessions: intent, decisions, open threads
- 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-recapAdd to claude_desktop_config.json
{
"mcpServers": {
"session-recap": {
"command": "npx",
"args": [
"-y",
"session-recap"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"session-recap": {
"command": "npx",
"args": [
"-y",
"session-recap"
]
}
}
}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.


