cursor-chat-browser

MCP server that indexes and searches past Cursor conversations across all workspaces


Keywords
cursor, mcp, model-context-protocol, conversation-search, ai-assistant, chat-history, full-text-search
License
MulanPSL-2.0
Install
npm install cursor-chat-browser@0.0.1

Documentation

cursor-chat-browser

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.

What it does

  • 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

Quick start

Add to your MCP client config:

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cursor-chat-browser": {
      "command": "npx",
      "args": ["-y", "cursor-chat-browser"]
    }
  }
}

Claude Desktop

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

Tools

search_conversations

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)

get_conversation

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_workspaces

List all workspaces with conversation counts.

recent_conversations

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)

reindex

Re-scan for new conversations added since the server started.

How it works

  1. On startup, scans ~/.cursor/projects/*/agent-transcripts/ for JSONL transcript files
  2. Parses each file into structured conversations (user messages, assistant responses)
  3. Indexes into a persistent SQLite FTS4 database at ~/.cursor/chat-browser/search-index.db
  4. Optionally enriches with metadata from Cursor's state.vscdb (timestamps, mode, branch) using the system sqlite3 CLI
  5. Serves MCP tools over stdio transport

Only new conversations are parsed on subsequent runs — the index is persistent.

Data sources

Source What it provides Required
~/.cursor/projects/*/agent-transcripts/ Full conversation content Yes
state.vscdb (via sqlite3 CLI) Timestamps, mode, branch metadata Optional

Platform support

Platform Transcripts Metadata enrichment
macOS Yes Yes (sqlite3 pre-installed)
Linux Yes Yes (sqlite3 usually available)
Windows Yes Requires sqlite3 in PATH

Requirements

  • Node.js >= 20
  • Cursor IDE (for conversation data)

License

Elastic License 2.0