Claude MCP Server

Search past Claude Code conversations. Local BM25 over JSONL with one-click claude --resume.

Local serverstdioTypeScript

What is the Claude MCP server?

If you already use Claude, the claude mcp server is the piece that lets your assistant work with it directly. Search past Claude Code conversations. Local BM25 over JSONL with one-click claude --resume.

What the server does

If you've ever caught yourself solving the same Docker, deployment, or auth bug twice in a month, this is for you. The package is local-only (no network calls), pure-JS (no native modules), and ships as a single npx-installable binary.

Installation

claude-remind-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • remind_search — BM25 search over past messages. Returns ranked hits with a snippet, a solvedHint, a messageUuid, and a ready-to-paste claude --resume command
  • remind_message — Fetch the full text of one message plus optional surrounding turns. Use after remind_search returns a messageUuid you want to read in full
  • remind_session — Structured summary of a session: title, message count, tool names used, files touched, error count, time span, solved hint, last user message
  • remind_resume — Resolves a session id (full or 8-char prefix) to a ready-to-run claude --resume command, plus the session's cwd and git branch. remind_search

Credentials and setup notes

  • Node.js ≥ 20 - A Claude Code installation that writes to ~/.claude/projects/ The package has two runtime dependencies: @modelcontextprotocol/sdk and minisearch. No native modules. ---

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Claude's toolset — remind_search, remind_message, remind_session and 1 more — is a fair guide to whether it matches your workflow. It is maintained by emretheus; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
remind_searchBM25 search over past messages. Returns ranked hits with a snippet, a solvedHint, a messageUuid, and a ready-to-paste claude --resume command.
remind_messageFetch the full text of one message plus optional surrounding turns. Use after remind_search returns a messageUuid you want to read in full.
remind_sessionStructured summary of a session: title, message count, tool names used, files touched, error count, time span, solved hint, last user message.
remind_resumeResolves a session id (full or 8-char prefix) to a ready-to-run claude --resume <id> command, plus the session's cwd and git branch. remind_search already returns this on every hit, so prefer that; this tool exists for t

How to install the Claude MCP server

{
  "mcpServers": {
    "claude-remind": {
      "command": "npx",
      "args": ["-y", "claude-remind-mcp"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js ≥ 20 - A Claude Code installation that writes to ~/.claude/projects/ The package has two runtime dependencies: @modelcontextprotocol/sdk and minisearch. No native modules. ---

Example prompts to try

  • Use Claude to remind search.
  • Use Claude to remind message.
  • Use Claude to remind session.

Frequently asked questions

It connects Claude to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (remind_search, remind_message, remind_session, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Claude directly.