mcpField
L
Local History

Local History

Local
github.com/xxczakiDeveloper Tools16Updated 1d ago
Repository

About Local History

Local History is an MCP server for accessing Cursor and VS Code Local History. It lets AI assistants inspect saved file versions, search history, and restore earlier content with a backup.

Key features

  1. 01List files with saved history
  2. 02View a file's complete history
  3. 03Read a specific history entry
  4. 04Restore an earlier version with backup
  5. 05Search history content and view statistics

Use cases

  1. 01Recover file content removed or overwritten
  2. 02Review earlier saved versions during debugging
  3. 03Search past snapshots for code or text

MCP support

Exposes Cursor and VS Code Local History through MCP tools for listing files, reading and searching entries, viewing statistics, and restoring versions.

#vscode#cursor#visual-studio-code#claude-code#local-history#backup#file-recovery

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "local-history": {
      "command": "npx",
      "args": [
        "-y",
        "local-history-mcp"
      ]
    }
  }
}
Run commandnpx -y local-history-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmlocal-history-mcp

Tools

6

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README
Demo

Local History MCP Server

Access Cursor/VS Code Local History through the Model Context Protocol for AI-powered data recovery

CI Release MCP

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:

# 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
git clone https://github.com/xxczaki/local-history-mcp.git && cd local-history-mcp
pnpm install
pnpm build
pnpm start

MCP Tools

ToolDescription
list_history_filesList all files with Local History
get_file_historyView complete history for a file
get_history_entryGet specific history entry content
restore_from_historyRestore file to previous state (with backup)
search_history_contentSearch across all history entries
get_history_statsOverview statistics

Configuration

Cursor

You can install this MCP server in Cursor using the one-click install button:

Install MCP Server

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-mcp

For 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 inspector

AI disclosure

This project contains code generated by Large Language Models (LLMs), under human supervision and proofreading.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.