# cursor-history

Connects an assistant to local Cursor chats so it can search conversations, inspect sessions, and produce exports. Useful when you need to recover an earlier fix or decision.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 33
- Author: S2thend
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/S2thend/cursor-history-mcp
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/mcp/cursor-history

## What it does

The server exposes local Cursor history to an MCP client. An assistant can search conversation text across workspaces, open matching sessions, and request an export. You don’t need to have used this server when the chats were created.

It requires Node.js 20.x or 22.x–26.x, readable Cursor history on the machine, and a client that can run local stdio MCP servers. The client must launch the server where the history files are stored. Search won’t work if those files aren’t accessible.

For parsing and discovery, it relies on `cursor-history` rather than keeping its own conversation database. Backup and restore apply to Composer databases only. Agent transcripts can lack timestamps or tool results, so they may not show the full session context.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add cursor-history -- npx -y cursor-history-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add cursor-history -- npx -y cursor-history-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cursor-history": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-history-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cursor-history": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "cursor-history-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cursor-history npx -y cursor-history-mcp
```

## When to use it
- find an earlier fix in Cursor conversations
- inspect sessions related to a bug
- request a chat export through MCP
- back up a Composer database

## Example prompts
- Search my Cursor history for how we fixed the authentication error before.
- Open the Cursor sessions about this bug and identify the relevant decisions.
- Export the Cursor conversation where we discussed project setup.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md