get_conversation_history
Get paginated conversation history (use after exploring with list_projects/list_sessions for targeted data)
LABSCO SUMMARY
Earlier Claude Code sessions become searchable, so past decisions can be recovered without scrolling.
The 4 tools read the local history: list_projects and list_sessions map what exists, then get_conversation_history and search_conversations pull the relevant parts. Nothing here writes; it reads history already on disk.
What it is
A reader over Claude Code's conversation history: its 4 tools list projects and sessions, fetch paginated history, and search past conversations by content.
What you get
- List projects that have conversation history (list_projects)
- List sessions for a project or date range (list_sessions)
- Fetch paginated conversation history for a session or range (get_conversation_history)
- Search past conversations by content (search_conversations)
Requirements
Local Claude Code conversation history on the machine where the server runs.
Setup effort
One command — npx claude-code-history-mcp
USE CASES
01
Finding where a topic was discussed before
Search past conversations by content across projects to locate the thread.
02
Recovering the history of one session
List the project's sessions, then pull the targeted conversation history.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
list_projects
List all projects with Claude Code conversation history (start here to explore available data)
list_sessions
List conversation sessions for a project or date range (use after list_projects to find specific sessions)
search_conversations
Search through conversation history by content (useful for finding specific topics across all conversations)
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"claude-code-history-mcp": {
"command": "npx",
"args": [
"claude-code-history-mcp"
]
}
}
}npx
TERMINAL
npx claude-code-history-mcp
