{"id":"jhammant-claudehistorymcp","name":"ClaudeHistoryMCP","homepage":null,"repo_url":"https://github.com/jhammant/ClaudeHistoryMCP","category":"devtools","subcategories":[],"tags":["mcp","claude","claude-code","search","hybrid-search","history-indexing","local-first","knowledge-extraction","cloud-sync"],"what_it_does":"Provides an MCP server plus optional CLI/hook to index and search Claude Code conversation history stored as JSONL under the local Claude projects directory, and to extract/surface prior decisions, solutions, and error-fix patterns. Optionally supports cloud sync via HTTP tools.","use_cases":["Search prior Claude Code sessions for fixes to recurring errors (e.g., ECONNREFUSED).","Retrieve summaries and structured context for a project based on recent sessions.","Discover recurring patterns/workflows from historical conversations.","Proactively inject prior project context at the start of new Claude Code sessions.","Sync indexed knowledge across devices/teams via a separate cloud server."],"not_for":["Auditing/compliance workflows that require formally verified summarization accuracy.","Use as a general-purpose web search or semantic retrieval service for non-Claude data.","High-assurance environments where local file access and indexing risks must be tightly controlled without additional hardening."],"best_when":"You have substantial Claude Code history locally and want fast, tool-driven retrieval of prior decisions and fixes during development.","avoid_when":"You cannot grant the process access to local Claude history files or you need a documented, production-grade API contract (schemas, error codes, pagination, SLAs) for automated agent use.","alternatives":["Local grep/rg + manual note-taking (no semantic search, no structured knowledge extraction).","A generic vector database/RAG setup over exported chat logs (requires more engineering).","Other MCP history/knowledge search tools if available in your ecosystem."],"af_score":54.5,"security_score":46.2,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:55:20.416581+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local filesystem access (no auth for MCP tools when run locally).","Cloud sync uses API key via environment variable (CLAUDE_HISTORY_API_KEY)."],"oauth":false,"scopes":false,"notes":"No MCP auth details are provided in the README. Cloud sync appears to use an API key, but the cloud API’s auth model/scopes are not documented here."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information stated; the project is MIT and described as a local MCP server with optional separate cloud server."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local-first by default (indexes local JSONL under ~/.claude/projects/).","Optional cloud sync via ClaudeHistory Cloud (data location depends on where that server is hosted)."],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":54.5,"security_score":46.2,"reliability_score":26.2,"mcp_server_quality":75.0,"documentation_accuracy":60.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":10.0,"tls_enforcement":50.0,"auth_strength":45.0,"scope_granularity":25.0,"dependency_hygiene":60.0,"secret_handling":55.0,"security_notes":"Local MCP execution appears unauthenticated and relies on local filesystem access; cloud sync uses an API key via environment variables but no details are provided about TLS enforcement, request signing, scope granularity, or safe logging. Cloud sync may transfer conversation content off-device, so access control and TLS details on the cloud server are important.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":40.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":"The README describes indexing and sync but does not document whether MCP tools are idempotent or how partial failures are handled.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Tool behavior and parameter schemas are not fully specified in the README; agents may need to infer or inspect the MCP tool definitions at runtime.","Search/filtering relies on the specified filter syntax; malformed filters may reduce results or fail without documented guidance.","Local indexing depends on filesystem layout and incremental indexing/file-watcher behavior; stale indexes may occur if the watcher/index timing fails."]}}