Claude Code Conversation Search

Provides an MCP server to search Claude Code conversations across projects and resume work instantly.

typescript

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tonysimonovsky-claude-code-conversation-search-mcp": {
      "command": "claude-code-conversation-search-mcp",
      "args": [],
      "env": {
        "DEBUG": "<DEBUG>",
        "MAX_RESULTS": "<MAX_RESULTS>",
        "AUTO_INDEXING": "<AUTO_INDEXING>",
        "INDEX_INTERVAL": "<INDEX_INTERVAL>",
        "CLAUDE_PROJECTS_DIR": "<CLAUDE_PROJECTS_DIR>",
        "CONVERSATION_DB_PATH": "<CONVERSATION_DB_PATH>",
        "DEFAULT_CONTEXT_SIZE": "<DEFAULT_CONTEXT_SIZE>"
      }
    }
  }
}

You can search Claude Code conversations across all your projects using the Claude Code Conversation Search MCP. This server lets you locate discussions, identify the exact project and date, and resume work with a ready‑to‑run command, dramatically reducing the time you spend hunting for context.

How to use

You interact with the MCP through an MCP client in Claude Code. Install the MCP, then enable a conversation-search server in your client configuration. Once configured, you can ask natural language questions like “where did we discuss the login bug?” or “find that Docker conversation.” The server will respond with the exact project path, timestamp, a concise summary of the discussion, and a smart resume command you can run to jump back into the conversation.

How to install

Prerequisites you need before starting:

Step-by-step installation and setup:

npm install -g claude-code-conversation-search-mcp

Run and configure the MCP server

After installation, the MCP server can be used directly with Claude Code. The server exposes a standard runtime that you run from the command line within Claude Code’s MCP framework.

Optional: global integration note

To ensure smooth integration, you can add guidance to your global Claude Code setup so that search queries trigger broad-to-narrow searches and produce human‑readable output with clear context and resume commands.

Configuration and usage basics

You can integrate the MCP server either globally or per project. The configuration primarily points Claude Code to the MCP server and its command entry points.

What you’ll see after a search

Each search returns the project name, the date/time of the discussion, a summary of what was discussed, and a ready-to-run resume command like: cd ~/.cs/project-name && claude --resume abc123.

Available tools

search_conversations

Search conversations with natural language queries, returning matching conversations with optional context and project details.

list_projects

List all indexed projects with statistics such as the number of messages and last activity date.

get_message_context

Retrieve surrounding messages for a given message to provide full context.

get_conversation_messages

Fetch messages from a specific conversation with pagination options.

list_tools

Show all available tools with their signatures and descriptions, updating automatically when new tools are added.

refresh_index

Manually trigger re-indexing to incorporate new conversations or projects.

get_server_info

Display server version, changelog, system status, and available tools.

Built by

VeilStrat

AI signals for GTM teams