# claude-find

Searches previous Claude Code dialogue logs using local Ollama embeddings and FTS5 to recover rationale and past decisions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: Cavinooo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Cavinooo/claude-find
- Updated: 2026-06-10
- HTML: https://affpapa.org/en/nevibecode/mcp/claude-find

## What it does

The server inspects project JSONL archives stored in `~/.claude/projects/` to run hybrid lookups across previous conversations. Instead of truncating discussions into brief outlines, it retrieves uncompressed message logs with recorded tool calls, branch metadata, and explicit trade-offs.

Information retrieval merges lexical matching via SQLite FTS5 with vector similarity from the `qwen3-embedding` weights inside Ollama. Results get sorted by reciprocal rank fusion. Index updates proceed asynchronously during startup, letting Claude begin queries without waiting for background tasks to finish.

Running this setup requires Bun on your path and a functioning Ollama instance. Without Ollama accessible locally, the embedding generation fails immediately.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add claude-find -- npx -y claude-find
```

### Codex

**Platform CLI**
```bash
codex mcp add claude-find -- npx -y claude-find
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "claude-find": {
            "command": "npx",
            "args": [
                "-y",
                "claude-find"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "claude-find": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "claude-find"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add claude-find npx -y claude-find
```

## When to use it
- locate architectural decisions buried in past terminal chats
- retrieve previous database migration steps and trade-offs
- revisit failed debugging attempts and error transcripts
- find touched files across earlier sessions via tool records

## Example prompts
- /find discussion about switching from long-polling to event streams
- /find past conversations regarding timeout errors in payments
- /find database schema updates completed last week

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md