mcp-recall-md 0.1.0

Local semantic search for markdown notes — MCP server

mcp-recall-md

Local semantic search for your markdown notes — via MCP
Search by meaning, not keywords. 100% offline.

Install  ·   Tools  ·   Auto-indexing  ·   Troubleshooting

---

Install

Option A: Python users

pip install mcp-recall-md

Add to your MCP config (.mcp.json for Claude Code, claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "mcp-recall-md": {
      "command": "mcp-recall-md",
      "args": []
    }
  }
}

Option B: Download exe (no Python needed)

1. Download mcp-recall-md.exe from the latest release
2. Put it in a permanent folder (e.g. C:\Tools\mcp-recall-md\)
3. Add to MCP config:

{
  "mcpServers": {
    "mcp-recall-md": {
      "command": "C:/Tools/mcp-recall-md/mcp-recall-md.exe",
      "args": []
    }
  }
}

Restart your app. Start asking:

"Search my knowledge base for Kubernetes networking"

"Find my notes about AWS Bedrock"

---

Tools

Tool	Parameters	What it does
index	key, content	Store or update an article
search	query, limit	Semantic similarity search
remove	key	Delete an article

---

Auto-indexing

To auto-index a folder of .md files and watch for changes:

mcp-recall-md-watcher --vault "C:/Users/you/notes"

This indexes all existing files on startup, then watches for new and modified files in real time.

---

Troubleshooting

Problem	Fix
Search returns nothing	Index files first — run the watcher or use the index tool
First run is slow	Embedding model (~80 MB) downloads once
Need to debug	Add --verbose flag

---

License

MIT