
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 toolsPublic 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_DIROverride the directory Claude Code stores logs in (default: ~/.claude). Must be an absolute path.
CLAUDE_REMIND_DIROverride 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.
demo
Details
- Repository
- github.com/emretheus/claude-remind-mcp
- Category
- Search & Web Crawling
- Package
claude-remind-mcp- Transport
- STDIO
- Registry
- MCP registry, active