ClaudeHistoryMCP

Overview

ClaudeHistoryMCP is a specialized MCP server that indexes Claude Code conversation history to make it searchable and reusable. It uses a hybrid search approach combining BM25 for keyword precision and TF-IDF for semantic recall, with Reciprocal Rank Fusion to combine results. The server automatically extracts knowledge from conversations, including decisions, solutions, and error-fix patterns, and can inject project context at the start of new sessions. It supports filter syntax for targeted searches and includes cloud sync capabilities for knowledge sharing.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• search_history

  Full-text search across all conversations with filter syntax

  Try:Have I dealt with this ECONNREFUSED error before?Try:Search for docker network errors in the last week
• find_solutions

  Find how you fixed errors/problems before

  Try:Find solutions for authentication issuesTry:How did I fix CORS problems last month?
• get_session_summary

  Structured summary of any session

  Try:Summarize my last sessionTry:What happened in the Docker session yesterday?
• list_projects

  List all projects with session counts and dates

  Try:Show all my projectsTry:List projects I've worked on in the last month
• find_patterns

  Discover recurring topics, workflows, and issues

  Try:What patterns emerge in my React development?Try:Find recurring deployment issues
• get_project_context

  Full project context (recent sessions, decisions, knowledge)

  Try:Get context for my current projectTry:What decisions were made in the API project?
• cloud_sync_push

  Push knowledge and sessions to cloud server

  Try:Sync my history to cloudTry:Push latest session data
• cloud_sync_pull

  Pull knowledge and sessions from cloud server

  Try:Update my local history from cloudTry:Pull latest session data from server
• cloud_sync_status

  Check cloud sync configuration and connection

  Try:Check cloud sync statusTry:Is my history syncing to cloud?

Comparable tools

Installation

git clone https://github.com/jhammant/ClaudeHistoryMCP.git
cd ClaudeHistoryMCP
npm install
npm run build

npm run build-index

claude mcp add claude-history -- node "/path/to/ClaudeHistoryMCP/dist/index.js"

npm run install-hook

## Claude History MCP

When the `claude-history` MCP is available, use it proactively:
- **Session start**: Use `get_project_context` to check for prior decisions, patterns, and recent session summaries
- **Debugging**: Use `find_solutions` to search history for past fixes before starting from scratch

FAQ

Does this work with all Claude Code conversations?

Yes, it indexes all JSONL conversation files stored in ~/.claude/projects/

How large can the history database be?

Tests show ~9s index build time for ~170 sessions, with searches <200ms

Can I sync knowledge across devices?

Yes, using the optional cloud sync feature with ClaudeHistory Cloud

Compare ClaudeHistoryMCP with