Claude Code History
About
Retrieve and analyze Claude Code conversation history from local files.
Details
- Author
- yudppp
- Categories
- Developer Tools, Other, AI
Jump to
Setup
Install Claude Code History in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/yudppp/claude-code-history-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server for retrieving and analyzing Claude Code conversation history with smart filtering and pagination.
This MCP server provides4 powerful toolsfor exploring your Claude Code conversation history:
Discover all projects with Claude Code conversation history.
Why use this first:Get an overview of all available data before diving deeper.
Returns:Project paths, session counts, message counts, and last activity time.
List conversation sessions for exploration and filtering.
- projectPath(optional): Filter by specific project
- startDate(optional): Start date (e.g., "2025-06-30")
- endDate(optional): End date (e.g., "2025-06-30")
- timezone(optional): Timezone for date filtering (e.g., "Asia/Tokyo", "UTC")
Returns:Session IDs, timestamps, message counts, and project paths.
3.get_conversation_historyπ¬Get Detailed Data
Retrieve paginated conversation history with smart filtering.
- Pagination:limit(default: 20) andoffsetfor efficient data handling
- Message Filtering:messageTypesdefaults to["user"]to reduce data volume
- Timezone Support: Automatic timezone detection or specify (e.g., "Asia/Tokyo")
- Date Filtering: Smart date normalization with timezone awareness
- sessionId(optional): Specific session ID
- startDate(optional): Start date (e.g., "2025-06-30")
- endDate(optional): End date (e.g., "2025-06-30")
- limit(optional): Max entries per page (default: 20)
- offset(optional): Skip entries for pagination (default: 0)
- messageTypes(optional):["user"](default),["user", "assistant"], etc.
- timezone(optional): e.g., "Asia/Tokyo", "UTC" (auto-detected)
{ "startDate": "2025-06-30", "limit": 50, "messageTypes": ["user"], "timezone": "Asia/Tokyo" }
{ "entries": [...], "pagination": { "total_count": 150, "limit": 20, "offset": 0, "has_more": true } }
4.search_conversationsπFind Specific Content
Search across all conversation content by keywords with advanced filtering.
- query(required): Search terms
- limit(optional): Max results (default: 30)
- projectPath(optional): Filter by specific project path
- startDate(optional): Start date (e.g., "2025-06-30")
- endDate(optional): End date (e.g., "2025-06-30")
- timezone(optional): Timezone for date filtering (e.g., "Asia/Tokyo", "UTC")
# Install directly via npx (no local installation needed) npx claude-code-history-mcp # Or install globally npm install -g claude-code-history-mcp
Add the following configuration to your MCP client (e.g., Claude Desktop):
{ "mcpServers": { "claude-code-history": { "command": "npx", "args": ["claude-code-history-mcp"] } } }
Alternatively, if you have installed the package globally:
{ "mcpServers": { "claude-code-history": { "command": "claude-code-history-mcp" } } }
// Start with list_projects to see what's available {"tool": "list_projects"}
// List sessions for a specific project or date range with timezone { "tool": "list_sessions", "projectPath": "/Users/yourname/code/my-project", "startDate": "2025-06-30", "timezone": "Asia/Tokyo" }
// Get conversation history with optimal settings { "tool": "get_conversation_history", "sessionId": "specific-session-id", "messageTypes": ["user"], // Only your inputs (default) "limit": 50 }
This server reads Claude Code history files (.jsonl format) stored in~/.claude/projects/.
- Default: Only["user"]messages to reduce data volume
- Full conversation: Use["user", "assistant"]
- Everything: Use["user", "assistant", "system", "result"]
- Automatically detects your system timezone
- Supports explicit timezone specification (e.g., "Asia/Tokyo")
- Smart date normalization (e.g., "2025-06-30" β proper timezone bounds)
- Efficient handling of large datasets
- total_counthelps you understand data volume
- has_moreindicates if there's additional data
- list_projectsβ See active projects
- get_conversation_historywith today's date andmessageTypes: ["user"]
- list_sessionswith specific project path
- get_conversation_historyfor relevant sessions
- Use pagination to browse through all data
Find all conversations about "API integration" in a specific project
- search_conversationswith query "API integration", projectPath, and date range
- Use results to identify relevant sessions
- get_conversation_historyfor detailed context
{ "tool": "search_conversations", "query": "API integration", "projectPath": "/Users/yourname/code/my-project", "startDate": "2025-06-01", "endDate": "2025-06-30", "timezone": "Asia/Tokyo", "limit": 50 }
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
next-devtools-mcp is a MCP server that provides Next.js development tools and utilities for AI coding assistants like Claude and Cursor.
A demonstration server for ActionKit, providing access to Slack actions via Claude Desktop.
MCP server that lets Claude Code agents delegate tasks to agents in other project directories, with parallel dispatch, sessions, and async jobs.
Anchor Browser (https://anchorbrowser.io) is secure infrastructure for computer-use agents β stealth cloud browsers, authentication, captcha bypass, and a hosted MCP server for Cursor, Claude, and Windsurf.
Open-source Claude Code plugin replacing Read/Grep/Edit/Bash with token-efficient versions. Independently benchmarked at 57% token reduction on real codebases. 40 MCP tools.
Connects Blender to Claude AI via the Model Context Protocol (MCP), enabling direct interaction and control for prompt-assisted 3D modeling, scene creation, and manipulation.
Context-optimized security plugin for Claude Code that builds architecture maps and redacts secrets.
Charon gives AI clients scoped, auditable access to Lethe memory. connect to Chatgpt or Claude to store memories locally.
Score CLAUDE.md/AGENTS.md, validate clarx-manifest.json, generate CI workflows, and pull repo scan findings into Cursor, Claude, or Grok.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





