# io.github.emretheus/claude-remind-mcp (npm · claude-remind-mcp)

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

- Trust score: 72/100 (medium)
- Change this week: +29
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `claude-remind-mcp`: 72/100 (this document), [markdown](https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp.md), [page](https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp)

## Channel facts

- Registry: `npm`
- Package: `claude-remind-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to emretheus/claude-remind-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 84 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 846 tokens (~211/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 91% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add emretheus-claude-remind-mcp -- npx -y claude-remind-mcp
```

### Codex

```bash
codex mcp add emretheus-claude-remind-mcp -- npx -y claude-remind-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "emretheus-claude-remind-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "claude-remind-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add emretheus-claude-remind-mcp --command npx --arg -y --arg claude-remind-mcp
```

### Hermes

```yaml
mcp_servers:
  emretheus-claude-remind-mcp:
    command: "npx"
    args: ["-y", "claude-remind-mcp"]
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 72, +22)

- [security regression] Provenance: pass → unverified
- [security regression] Install scripts: pass → unverified
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: emretheus/claude-remind-mcp
- [functional regression] Maintenance: pass → unverified
- [functional regression] License: pass → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-08-01 (score 50, +27)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] MCP protocol: unverified → pass

### 2026-07-31 (score 23, −47)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 70, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-29 (score 88, +45)

- [security improvement] Known CVEs: unverified → partial
- [security improvement] Provenance: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security] The attested source repository moved: emretheus/claude-remind-mcp
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional] Licence: MIT

### 2026-07-27 (score 43)

First indexed and scored.

## MCP tools (4)

### `remind_search` (~377 tokens)

Search past Claude Code sessions for solutions to recurring problems. Returns BM25-ranked hits with a snippet, a `solvedHint`, a `messageUuid`, and a ready-to-paste `claude --resume <id>` command.

When to use: at the start of a task to check for prior work on the same codebase; or when the user mentions an error, tool, or feature they may have already solved. One call is usually enough — only re-call with a different query if the first returned no useful hits.

Query tips: use specific concrete terms — exact error strings (`ExpiredTokenException`, `LoginRefreshRequired`), tool/lib names (`BuildKit`, `Cognito`, `Tailwind`), or real file paths (`tailwind.config`, `shared_auth/jwt.py`). Avoid generic words that flood the corpus (e.g. `AWS`, `auth`, `docker` on their own). Good: `ExpiredTokenException SendSSHPublicKey`. Bad: `AWS auth issue`.

Cost: ~1–2 KB per call at default (5 hits, 1000-char snippets). Use `format: "compact"` (400 chars) for cheap scans, `format: "full"` (2000 chars) when you need to read in place. After finding a relevant hit, call `remind_message` with its `messageUuid` to read the full content.

Input parameters:

- `format` (string): Snippet length: compact=400, detailed=1000, full=2000 chars.
- `limit` (integer)
- `project` (string): Optional. Substring match against the session's cwd (e.g. 'my-app').
- `query` (string, required): Free-text search query.
- `sinceDays` (integer): Optional. Only include sessions updated within the last N days.

### `remind_message` (~210 tokens)

Fetch the full text of a specific past message, plus optional surrounding turns. Returns up to ~10 KB; the matched message is flagged with `isFocus: true` inside the returned window.

When to use: only after `remind_search` returns a `messageUuid` whose snippet looks promising but is truncated. Don't call this for every search hit — pick the one or two most relevant first. If you want a structural overview of the whole session (tools, files, errors), call `remind_session` instead.

To read the entire session, omit `messageUuid` (capped at 50 messages).

Input parameters:

- `contextAfter` (integer): Messages after the focus message.
- `contextBefore` (integer): Messages before the focus message.
- `messageUuid` (string): Optional. If provided, returns this message plus context window. If omitted, returns all indexed messages of the session (capped at 50).
- `sessionId` (string, required): Full or prefix of the session UUID.

### `remind_session` (~135 tokens)

Get a structured summary of one past session: title, message count, tool names used, files touched, error count, time span, solved hint, and the last user message. Cheap (~1 KB).

When to use: when a `remind_search` hit looks relevant and you need the bigger picture (was this session productive? which tools/files were involved?) before drilling into specific messages. Requires a `sessionId` — the 8-char prefix from a search hit is enough. To read message bodies, use `remind_message` instead.

Input parameters:

- `sessionId` (string, required): Full or prefix of the Claude session UUID.

### `remind_resume` (~124 tokens)

Resolve a (full or 8-char prefix) session id into a ready-to-run `claude --resume <id>` command, plus the session's cwd and git branch.

When to use: only when you already have a sessionId in hand and need just the resume command. `remind_search` already returns `resumeCommand` on every hit, so prefer that. This tool exists for cases where the user pastes a bare sessionId or a previous tool flow stored only the id.

Input parameters:

- `sessionId` (string, required): Full or prefix of the Claude session UUID.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp#diagnostics

## Score history

- 2026-08-03: 72
- 2026-08-02: 72
- 2026-08-01: 50
- 2026-07-31: 23
- 2026-07-30: 70
- 2026-07-29: 88
- 2026-07-28: 43
- 2026-07-27: 43

## Links

- npm package: https://www.npmjs.com/package/claude-remind-mcp
- Socket report: https://socket.dev/npm/package/claude-remind-mcp
- Repository: https://github.com/emretheus/claude-remind-mcp
- Changelog RSS feed: https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/emretheus-claude-remind-mcp/claude-remind-mcp