github.com/S2thend/cursor-history-mcp @v0.2.4
Chat with this repoWhat it actually does AI analysis from the code graph — generated when you open this
README
Cursor History MCP
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.
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 |
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
Extension points exported contracts — how you extend this code
Core symbols most depended-on inside this repo
Shape
Languages
Modules by API surface
For agents
$ claude mcp add cursor-history-mcp \
-- python -m otcore.mcp_server <graph>