Vvkmnn/claude-historian-mcp

📜 An MCP server for conversation history search and retrieval in Claude Code

177 ★18 forksTypeScriptUpdated 2mo ago

What you need to know

MCP server for searching your Claude Code conversation history to find past solutions, track file changes and learn from previous work, with zero dependencies

Install

claude mcp add claude-historian-mcp -- npx claude-historian-mcp

Usage

•Search with the search tool across 11 scopes like conversations, errors, plans, files and memories
•Inspect any session by ID or short prefix with the inspect tool

Key features

✓Two tools and 11 scopes with no external databases
✓TF-IDF inspired scoring and workflow pattern detection
✓Parallel processing across projects and files with early termination
✓JSON streaming parser and LRU caching
✓Optional skill and plugin for proactive history checks
✓Reads local JSONL files only and never leaves the machine

Best for

Claude Code users who want to search past conversations and file change history

Caveats

⚠Claude Desktop history is not supported - stored server-side
⚠Node.js 20 or later required
⚠Zero tokens at idle but each query costs tokens

Platforms: macOS · Linux · WindowsClients: Claude Code · Cursor · Windsurf

Reviewed 2026-08-11

Topics

aiai-toolsanthropicclaudeclaude-codecontext-retrievalconversation-historydeveloper-toolsinverted-indexjsonlllmmcpmcp-servermemorymodel-context-protocolnodejs npx searchsessiontypescript

Stars: 177★
Forks: 18
Language: TypeScript
License: MIT
Created: 2025-07-14
Last push: 2026-06-15