Cursor History MCP Server

MCP server for browsing, searching, and exporting Cursor AI chat history

Local serverstdioPython

What is the Cursor History MCP Server?

MCP server for browsing, searching, and exporting Cursor AI chat history

What it actually does

Bring your Cursor AI chat history directly into Claude. Search past conversations, export sessions, create backups, and generate year-in-review reports—all through natural language. Built on the Model Context Protocol for seamless AI assistant integration.

Configuration

  • Node.js 20+ - Cursor IDE installed with existing chat history

Recorded tools

  • cursor_history_list — List chat sessions with metadata
  • cursor_history_show — View full conversation content
  • cursor_history_search — Search across all sessions
  • cursor_history_export — Export session to Markdown or JSON
  • cursor_history_backup — Create backup of all history
  • cursor_history_restore — Restore from backup (destructive)
  • cursor_history_migrate — Move/copy sessions between workspaces (destructive)
  • cursor_history_year_pack — Generate year-in-review data package with stats, topics, and prompt template

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
cursor_history_listList sessions with IDs, index scope, source and data status. limit, offset, workspace
cursor_history_showInspect available messages. Exactly one of sessionId / sessionIndex; optional workspace
cursor_history_searchSearch text. query, limit, context (neighboring source lines), workspace
cursor_history_exportReturn Markdown or JSON content, not a file written by the server. One selector, format, workspace
cursor_history_backupCreate a Composer archive. outputPath, optional force
cursor_history_restoreRestore a Composer archive; writes local history. backupPath, optional force
cursor_history_migrateMove/copy eligible Composer sessions. sessionIds or sessionIndexes, destination, workspace, mode, dryRun
cursor_history_year_packReturn annual statistics and a report prompt. year, language (en / zh), workspace, sample limits

How to install the Cursor History MCP Server

{
  "mcpServers": {
    "cursor-history": {
      "command": "npx",
      "args": [
        "-y",
        "cursor-history-mcp@0.3.1"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 20+ - Cursor IDE installed with existing chat history

Example prompts to try

  • “Use Cursor History MCP to cursor history list.”
  • “Use Cursor History MCP to cursor history show.”
  • “Use Cursor History MCP to cursor history search.”

Frequently asked questions

MCP server for browsing, searching, and exporting Cursor AI chat history Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.