emretheus avatar

Claude Remind Mcp

emretheus/claude-remind-mcp

Indexes your local Claude Code conversation history under ~/.claude/projects/ with BM25 and lets Claude search past sessions without re-explaining problems you've already solved. Four tools: remind_search queries by keyword with filters for project and recency, remind_message fetches full conversation context around a hit, remind_session returns structured metadata, and remind_resume generates the claude --resume command to jump back into an old thread. Built-in secret redaction strips API keys and tokens before indexing. Runs entirely local over stdio with no network calls. Useful when you're hitting the same infrastructure bug twice or need to recall how you configured something in a different project months ago.

GitHub stars
1
tools
4
transport
STDIO
env vars
2
last updated
May 10, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

remind_searchBM25 search over past messages. Returns ranked hits with a snippet, a solvedHint, a messageUuid, and a ready-to-paste claude --resume command.

BM25 search over past messages. Returns ranked hits with a snippet, a solvedHint, a messageUuid, and a ready-to-paste claude --resume command.

No parameter schema in public metadata yet.

remind_messageFetch the full text of one message plus optional surrounding turns.

Fetch the full text of one message plus optional surrounding turns.

No parameter schema in public metadata yet.

remind_sessionStructured summary of a session: title, message count, tool names used, files touched, error count, time span, solved hint, last user message.

Structured summary of a session: title, message count, tool names used, files touched, error count, time span, solved hint, last user message.

No parameter schema in public metadata yet.

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.

Resolves 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.

No parameter schema in public metadata yet.

Sponsors

Configuration

CLAUDE_CONFIG_DIR

Override the directory Claude Code stores logs in (default: ~/.claude). Must be an absolute path.

CLAUDE_REMIND_DIR

Override where the index is persisted (default: ~/.claude-remind). Must be an absolute path.

Readme

claude-remind-mcp

A Model Context Protocol (MCP) server that searches your local Claude Code conversation history. It indexes every past session under ~/.claude/projects/ with BM25, redacts secrets, and lets the running Claude agent recall and resume solutions you've already worked out — without re-explaining the problem from scratch.

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.

npm version License: MIT TypeScript Node.js

demo


View the full README on GitHub

Details

Repository
github.com/emretheus/claude-remind-mcp
Category
Search & Web Crawling
Package
claude-remind-mcp
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1fabric-protocol avatarFabric Marketplacefabric-protocol/fabricAgent-native marketplace. Bootstrap, list inventory, search, negotiate, and trade via MCP.1stars
2gamzadongza avatarDanbooru Tagsgamzadongza/danbooru-tags-mcpExtract tags from any Danbooru post and explore categories at a glance. Analyze character-specific tag frequencies to surface top traits and clothing patterns. 1stars
3getmystadmin avatarUrdb Mcpgetmystadmin/urdb-mcpSearch URDB for product integrity scores, enshittification events, and change tracking.1stars
4gregario avatarLorcana Oraclegregario/lorcana-oracleDisney Lorcana TCG MCP server with card search, deck analysis, ink curves, and set browsing1stars
5gregario avatarOnepiece Oraclegregario/onepiece-oracleOne Piece TCG MCP server with card search, deck analysis, and set browsing1stars
6groupdocs-metadata avatarGroupdocs Metadata Mcpgroupdocs-metadata/groupdocs.metadata.mcpMCP server for GroupDocs.Metadata — read, search, write, and remove document metadata.1stars