MCP server that indexes and searches your past Cursor AI conversations across all workspaces.
Works with any MCP client — Cursor, Claude Desktop, Windsurf, and others.
- Scans
~/.cursor/projects/*/agent-transcripts/for conversation history - Builds a persistent full-text search index (SQLite FTS4 via sql.js — zero native dependencies)
- Enriches conversations with metadata (timestamps, mode, branch) from Cursor's internal database
- Exposes 5 MCP tools for searching, browsing, and retrieving past conversations
Add to your MCP client config:
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"cursor-chat-browser": {
"command": "npx",
"args": ["-y", "cursor-chat-browser"]
}
}
}Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"cursor-chat-browser": {
"command": "npx",
"args": ["-y", "cursor-chat-browser"]
}
}
}Then restart your MCP client. The server indexes all conversations on first run (~3s for 1,000 conversations) and uses a persistent cache for fast subsequent startups (~150ms).
Full-text search across all past conversations.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | yes | Keywords, function names, concepts, or phrases |
workspace |
string | no | Filter by project name (partial match) |
limit |
number | no | Max results (default: 10) |
Retrieve full content of a specific conversation.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
string | yes | Conversation UUID from search results |
max_length |
number | no | Truncate at N chars (default: 10,000) |
List all workspaces with conversation counts.
Browse most recent conversations.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace |
string | no | Filter by project name (partial match) |
limit |
number | no | Number of results (default: 10) |
Re-scan for new conversations added since the server started.
- On startup, scans
~/.cursor/projects/*/agent-transcripts/for JSONL transcript files - Parses each file into structured conversations (user messages, assistant responses)
- Indexes into a persistent SQLite FTS4 database at
~/.cursor/chat-browser/search-index.db - Optionally enriches with metadata from Cursor's
state.vscdb(timestamps, mode, branch) using the systemsqlite3CLI - Serves MCP tools over stdio transport
Only new conversations are parsed on subsequent runs — the index is persistent.
| Source | What it provides | Required |
|---|---|---|
~/.cursor/projects/*/agent-transcripts/ |
Full conversation content | Yes |
state.vscdb (via sqlite3 CLI) |
Timestamps, mode, branch metadata | Optional |
| Platform | Transcripts | Metadata enrichment |
|---|---|---|
| macOS | Yes | Yes (sqlite3 pre-installed) |
| Linux | Yes | Yes (sqlite3 usually available) |
| Windows | Yes | Requires sqlite3 in PATH |
- Node.js >= 20
- Cursor IDE (for conversation data)