# Local History Mcp

> MCP server for accessing VS Code/Cursor's Local History

- **Type:** MCP server
- **Install:** `agentstack add mcp-xxczaki-local-history-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [xxczaki](https://agentstack.voostack.com/s/xxczaki)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [xxczaki](https://github.com/xxczaki)
- **Source:** https://github.com/xxczaki/local-history-mcp
- **Website:** https://www.npmjs.com/package/local-history-mcp

## Install

```sh
agentstack add mcp-xxczaki-local-history-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [xxczaki](https://github.com/xxczaki)
- **Source:** [xxczaki/local-history-mcp](https://github.com/xxczaki/local-history-mcp)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/local-history-mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-xxczaki-local-history-mcp
- Seller: https://agentstack.voostack.com/s/xxczaki
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.