mcp-recall-md

<h1 align="center">mcp-recall-md</h1>

<p align="center"> Local semantic search for your markdown notes — via <a href="https://modelcontextprotocol.io/">MCP</a>. </p>

<p align="center"> <a href="https://pypi.org/project/mcp-recall-md/"></a> <a href="https://pypi.org/project/mcp-recall-md/"></a> <a href="LICENSE"></a> <a href="https://ko-fi.com/kalikinartem"></a> </p>

<br>

graph LR
    A["<b>.md files</b><br><i>Obsidian · Logseq · plain md</i>"] -- "watch + index" --> B["<b>mcp-recall-md</b><br><i>local vector store</i>"]
    C["<b>AI client</b><br><i>Claude · Cursor · Windsurf</i>"] -- "MCP search" --> B
    style A fill:#f9f4eb,stroke:#c9a96e,color:#333
    style B fill:#e8f0fe,stroke:#4a86c8,color:#333
    style C fill:#e8f5e9,stroke:#5b9a5b,color:#333

> "Search my notes about Kubernetes networking" > > → finds kubernetes-networking.md (similarity: 0.53) — even though you phrased it differently than the note

<br>

• Search by meaning, not keywords — finds notes even when your wording doesn't match
• 100% offline — no API keys, no cloud, nothing leaves your machine
• Zero config — point at your folders, restart your AI client, done
• Real-time sync — file watcher picks up changes instantly, re-embeds only what changed

---

Add to your MCP client config and restart:

{
  "mcpServers": {
    "mcp-recall-md": {
      "command": "uvx",
      "args": ["mcp-recall-md", "--vaults", "C:/Users/you/notes"]
    }
  }
}

> Config file location: .mcp.json (Claude Code) · claude_desktop_config.json (Claude Desktop) · Cursor / Win