Back to Browse
Free
Server data from the Official MCP Registry
MCP server for browsing, searching, exporting, and backing up your Cursor AI chat history
About
MCP server for browsing, searching, exporting, and backing up your Cursor AI chat history
Security Report
6.0
Moderate6.0Moderate RiskValid MCP server (1 strong, 1 medium validity signals). 3 known CVEs in dependencies (1 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-s2thend-cursor-history": {
"args": [
"-y",
"cursor-history-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Cursor History MCP
🇨🇳 中文文档 | 🇫🇷 Français | 🇪🇸 Español
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.
Installation
No installation required! Run directly via npx:
npx cursor-history-mcp
Configuration
Cursor
Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"cursor-history": {
"command": "npx",
"args": ["-y", "cursor-history-mcp"]
}
}
}
Claude Desktop
Add to your Claude Desktop configuration (~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"cursor-history": {
"command": "npx",
"args": ["-y", "cursor-history-mcp"]
}
}
}
Available Tools
| Tool | Description |
|---|---|
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 |
🎆 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.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
56
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local