Cursor History

Provides fast, offline access to Cursor AI chat history with search, export, backup, and migration capabilities via the MCP.

typescript

26

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

The Cursor History MCP provides a fast, offline way to browse, search, export, and back up your Cursor AI chat history using a lightweight MCP server. It reads Cursor’s native SQLite data directly, supports grep-style searches, and can export or migrate sessions without requiring external AI services. This makes it ideal for keeping your chat history portable and securely accessible from your preferred MCP-enabled clients.

How to use

You will run the MCP server locally and connect your MCP client to it using the standard MCP configuration. Start by launching the server with a command compatible with your setup, then configure your client to point at the local MCP server. Once connected, you can list sessions, view conversations, search across history, export sessions, backup data, and migrate sessions between workspaces. The server is designed to work offline and reads directly from Cursor’s SQLite database for fast, reliable results.

How to install

# Prerequisites
- Node.js 20+ installed on your system
- Cursor IDE with existing chat history (as you will back up or migrate from it)

# Run the MCP server directly with npx
npx cursor-history-mcp

Configuration and usage notes

Configure your MCP client to connect to the Cursor History MCP server. Use the provided examples for your client’s MCP settings.

// Claude Code MCP settings
{
  "mcpServers": {
    "cursor-history": {
      "command": "npx",
      "args": ["-y", "cursor-history-mcp"]
    }
  }
}

// Claude Desktop configuration
{
  "mcpServers": {
    "cursor-history": {
      "command": "npx",
      "args": ["-y", "cursor-history-mcp"]
    }
  }
}

Available 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