# session-recap

> session-recap is a free MCP server for developer tools. Condensed recaps of past AI coding sessions: intent, decisions, open threads. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux
- **Repository:** https://github.com/brucexcluding/session-recap
- **MCP Registry name:** io.github.BruceXcluding/session-recap
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/session-recap
