Local History MCP Server

<img width="300" alt="Demo" align="right" src="https://github.com/user-attachments/assets/30dd1ac2-b1de-485f-9735-4813076587e5" /> # Local History MCP Server > Access Cursor/VS Code Local History through the Model Context Protocol for AI-powered data recovery [](https://github.com/xxczaki/local-history-mcp/actions/workflows/ci.yml) [](https://github.com/xxczaki/local-history-mcp/actions/workflows/publish.yml) [](https://modelcontextprotocol.io) ## Overview This MCP server bridges the gap between AI assistants and editor Local History, enabling data recovery and enhanced context awareness. Unlike undo/redo, Local History captures file snapshots at save points, preserving work that would otherwise be lost. **Problem**: Current AI assistants (Claude, Cursor AI, GitHub Copilot) cannot access Local History data despite having extensive diagnostic capabilities. **Solution**: Simple MCP server providing direct access to Cursor/VS Code Local History for personal use. ## Installation ### Option 1: Package Manager (Recommended) Install using your preferred package manager: ```bash # npm npx local-history-mcp # pnpm pnpm dlx local-history-mcp # yarn yarn global add local-history-mcp # bun bunx local-history-mcp ``` ### Option 2: From Source ```bash git clone https://github.com/xxczaki/local-history-mcp.git && cd local-history-mcp pnpm install pnpm build pnpm start ``` ## MCP Tools | Tool | Description | |------|-------------| | `list_history_files` | List all files with Local History | | `get_file_history` | View complete history for a file | | `get_history_entry` | Get specific history entry content | | `restore_from_history` | Restore file to previous state (with backup) | | `search_history_content` | Search across all history entries | | `get_history_stats` | Overview statistics | ## Configuration ### Cursor You can install this MCP server in Cursor using the **one-click install button**: [](https://cursor.com/en/install-mcp?name=local-history&config=eyJjb21tYW5kIjogIm5weCIsICJhcmdzIjogWyIteSIsICJsb2NhbC1oaXN0b3J5LW1jcCJdfQo%3D) Or manually configure by following the [official Cursor MCP documentation](https://docs.cursor.com/en/context/mcp). ### Claude Code & Claude Desktop For **Claude Code** (CLI), install directly: ```bash claude mcp add local-history -- npx -y local-history-mcp ``` For **Claude Desktop**, see the [official MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp). ### VS Code See the [official documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server). ## Development ```bash # Development mode pnpm dev # Run tests pnpm test # Linting and formatting pnpm lint # Launch MCP Inspector pnpm inspector ``` ## AI disclosure This project contains code generated by Large Language Models (LLMs), under human supervision and proofreading. ### License MIT