Skip to main content
Glama

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

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

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:

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

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables AI assistants to access and interact with Cursor/VS Code Local History data for file recovery and enhanced context awareness. Provides tools to browse file history, search across snapshots, and restore previous versions of files.

  1. Overview
    1. Installation
      1. Option 1: Package Manager (Recommended)
      2. Option 2: From Source
    2. MCP Tools
      1. Configuration
        1. Cursor
        2. Claude Code & Claude Desktop
        3. VS Code
      2. Development
        1. AI disclosure
          1. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A Cursor-compatible toolkit that provides intelligent coding assistance through custom AI tools for code architecture planning, screenshot analysis, code review, and file reading capabilities.
          Last updated -
          575
          10
          TypeScript
          MIT License
        • -
          security
          A
          license
          -
          quality
          A specialized server that provides backup and restoration capabilities for AI agents and code editing tools, creating instant targeted backups with context preservation.
          Last updated -
          8
          JavaScript
          MIT License
        • -
          security
          F
          license
          -
          quality
          A comprehensive memory management system for Cursor IDE that allows AI assistants to remember, recall, and manage information across conversations through a user-friendly interface.
          Last updated -
          2
          Python
        • A
          security
          A
          license
          A
          quality
          Allows AI assistants to access and analyze your Cursor conversation history, enabling personalized coding assistance based on your actual development patterns.
          Last updated -
          8
          618
          12
          TypeScript
          MIT License
          • Apple
          • Linux

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/xxczaki/local-history-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server