Skip to main content
Glama
Local History MCP Server

Local History MCP Server

by xxczaki

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.

Related MCP server: Local Filesystem MCP Server

Installation

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

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:

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

Available Tools

6 tools
get_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

    A3.9/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct operation—retrieving full history, a specific entry, statistics, listing files, restoring, or searching—with no overlap in purpose.

    Naming Consistency5/5

    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.

    Tool Count5/5

    With six tools, the server covers core local history workflows without unnecessary complexity—appropriate for its focused scope.

    Completeness5/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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