MCP server for browsing, searching, exporting, and backing up your Cursor AI chat history
io.github.S2thend/cursor-history MCP Server
This MCP server provides tools to browse, search, export, and back up your Cursor AI chat history. It is positioned for developers working with Cursor’s chat data and related workflows, and is distributed as an npm package. Topics include backup, chat-history, export, and TypeScript.
🛠️ Key Features
Browse Cursor AI chat history
Search chat history
Export chat history
Back up chat history
🚀 Use Cases
Locating prior Cursor AI conversations by search
Exporting chat history for sharing or record-keeping
MCP server for browsing, searching, exporting, and backing up your Cursor AI chat history.
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.
Free, open-source, and MIT licensed. Built by the community, for the community.
Why This Project?
There are other Cursor history tools out there (like the Python-based Cursor-history-MCP). Here's what makes this one different:
Feature
cursor-history-mcp (this project)
Other Solutions
📦 Setup
✅ npx cursor-history-mcp - zero install
❌ Docker, Python, dependencies
⚡ Speed
✅ Instant - direct SQLite reads
❌ Slow - requires LLM vectorization
🔍 Search
✅ Grep-style text matching - precise & stable
❌ Vector retrieval - unpredictable results
🤖 LLM Required
✅ No - works offline
❌ Yes - needs Ollama/embeddings
🛠️ Language
✅ TypeScript (type-safe)
⚠️ Python
💾 Backup/Restore
✅ Built-in
❌ Not available
🚚 Migration
✅ Move sessions between workspaces
❌ Not available
📋 Dependencies
✅ Minimal (just Node.js)
❌ Docker, LanceDB, Ollama, FastAPI
Key Advantages
Blazing Fast: No embedding or vectorization step. Reads directly from Cursor's native SQLite database, so results are instant.
Grep-Style Search: Uses direct text matching instead of vector retrieval. More lightweight, predictable, and stable for most use cases—no hallucinated results, no embedding drift, and exact matches every time.
Zero Configuration: Run with npx - no Docker containers, no Python environments, no API keys, no LLM setup.
Works Offline: Everything runs locally without any external services or AI models.
Data Portability: Full backup, restore, and cross-workspace migration capabilities to keep your chat history safe and portable.
Lightweight: ~50KB package vs multi-GB Docker images with vector databases.
Move/copy sessions between workspaces (destructive)
cursor_history_year_pack
Generate year-in-review data package with stats, topics, and prompt template
🎆 Year in Review
Generate a personalized annual report from your Cursor AI chat history — discover your coding patterns, favorite topics, and development journey.
What You Get
📊 Chat Stats
Total questions, active months, monthly activity
🏷️ Topic Discovery
Auto-detected coding topics and interests
📈 Trend Tracking
How your focus shifted throughout the year
🔑 Keywords
Your most-used terms and phrases
🔒 Privacy Safe
Sensitive data automatically masked
📝 LLM Prompt
Ready-to-use prompt for a polished report
Try It
"Generate my 2025 Cursor year in review"
"Create a year pack for ~/myapp"
"Generate my 2025 year in review in English"
Usage Examples
After configuring, ask your AI assistant:
"List my Cursor chat sessions"
"Show me session #1"
"Search my Cursor history for 'authentication'"
"Export session #1 as markdown"
"Backup my Cursor chat history"
Requirements
Node.js 20+
Cursor IDE installed with existing chat history
Contributing
Contributions are welcome! Whether it's bug reports, feature requests, documentation improvements, or code contributions—all PRs and issues are appreciated.
