Local History MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Local History MCP Server show me the recent changes to my main.py file"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Local History MCP Server
Access Cursor/VS Code Local History through the Model Context Protocol for AI-powered data recovery
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.
Related MCP server: Local Filesystem MCP Server
Installation
Option 1: Package Manager (Recommended)
Install using your preferred package manager:
# npm
npx local-history-mcp
# pnpm
pnpm dlx local-history-mcp
# yarn
yarn global add local-history-mcp
# bun
bunx local-history-mcpOption 2: From Source
git clone https://github.com/xxczaki/local-history-mcp.git && cd local-history-mcp
pnpm install
pnpm build
pnpm startMCP Tools
Tool | Description |
| List all files with Local History |
| View complete history for a file |
| Get specific history entry content |
| Restore file to previous state (with backup) |
| Search across all history entries |
| Overview statistics |
Configuration
Cursor
You can install this MCP server in Cursor using the one-click install button:
Or manually configure by following the official Cursor MCP documentation.
Claude Code & Claude Desktop
For Claude Code (CLI), install directly:
claude mcp add local-history -- npx -y local-history-mcpFor Claude Desktop, see the official MCP documentation.
VS Code
See the official documentation.
Development
# Development mode
pnpm dev
# Run tests
pnpm test
# Linting and formatting
pnpm lint
# Launch MCP Inspector
pnpm inspectorAI disclosure
This project contains code generated by Large Language Models (LLMs), under human supervision and proofreading.
License
MIT
Available Tools
6 toolsget_file_historyB
Get the complete history for a specific file
Inputs: filePath (required).
get_history_entryA
Get a specific history entry for a file
Inputs: filePath (required), entryIndex (required).
get_history_statsA
Get statistics about the local history (total files, entries, etc.)
Inputs: no named parameters.
list_history_filesA
List all files that have local history entries in VS Code
Inputs: no named parameters.
restore_from_historyB
Restore a file to a specific point in its local history
Inputs: filePath (required), entryIndex (required), createBackup.
search_history_contentB
Search for specific content across all history entries
Inputs: searchTerm (required), caseSensitive.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct operation—retrieving full history, a specific entry, statistics, listing files, restoring, or searching—with no overlap in purpose.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_file_history, restore_from_history), making the set predictable and easy to navigate.
With six tools, the server covers core local history workflows without unnecessary complexity—appropriate for its focused scope.
The tools provide a complete lifecycle: querying history, listing tracked files, retrieving entries, restoring files, and searching content—no obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
Shared memory for AI coding agents. Save once, reuse from Cursor, Claude Code, Codex.
Securely search and manage workspace context files for AI agents and teams.
One searchable history across every AI coding tool, with secret scanning and a shared task board.
Files and tables your AI reads and writes from any chat, with version history and sharing.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying, searching, and analyzing Cursor IDE conversation history from SQLite workspaceStorage databases. Supports exporting chat data in multiple formats and provides workspace utilities for managing conversation data across projects.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to securely browse, search, inspect, and understand local project files through Model Context Protocol tools.1MIT
- AlicenseBqualityDmaintenanceProvides AI assistants with VS Code integration for file operations, command execution, project analysis, and development workflow automation.29MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to generate annotated file trees, retrieve file statistics, list git-changed files, and read file contents from local directories or GitHub repositories.MIT