mcp-recall-md
Enables semantic search over markdown notes stored in Logseq vaults, allowing AI assistants to find relevant content by meaning rather than exact keyword matches.
Enables semantic search over markdown notes stored in Obsidian vaults, allowing AI assistants to find relevant content by meaning rather than exact keyword matches.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-recall-md search my notes about Kubernetes networking"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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
Quick start
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 / Windsurf MCP settings
That's it. Your notes are searchable.
Related MCP server: Semantic Search MCP
Installation
The quick start above uses uvx (recommended). Other options:
pip install mcp-recall-md{
"mcpServers": {
"mcp-recall-md": {
"command": "mcp-recall-md",
"args": ["--vaults", "C:/Users/you/notes"]
}
}
}Download mcp-recall-md.exe from the latest release
Put it somewhere permanent (e.g.
C:\Tools\mcp-recall-md\)
{
"mcpServers": {
"mcp-recall-md": {
"command": "C:/Tools/mcp-recall-md/mcp-recall-md.exe",
"args": ["--vaults", "C:/Users/you/notes"]
}
}
}Configuration
Multiple vaults
List all folders — each is indexed independently:
"args": ["--vaults", "C:/notes/work", "C:/notes/personal", "C:/docs"].recallignore
Drop a .recallignore in any vault root to exclude files. Standard .gitignore syntax:
.obsidian/
_templates/
drafts/CLI flags
Flag | Default | Description |
| (none) | Folders to index and watch |
|
| ChromaDB storage location |
| off | Debug logging to stderr |
Tools
Your AI assistant gets these tools automatically via MCP:
Tool | Description |
| Find notes by meaning — returns ranked results with similarity scores and file paths |
| Show indexed article count and watched vaults |
| Manually store an article (for use without |
| Delete an article from the index |
Most users only interact with search — everything else is automatic.
Troubleshooting
Problem | Fix |
Search returns nothing | Check that |
First run is slow | Embedding model (~80 MB) downloads once on first use |
Need to debug | Add |
Force re-index | Delete |
Logs: ~/.mcp-recall-md/server.log (5 MB max, 3 rotated backups)
Limitations
Single-chunk embedding — large files (10k+ words) may search less precisely than shorter notes
English-optimized — other languages work but with lower accuracy
License
MIT
Available Tools
4 toolsindexB
Index a knowledge base article. Replaces any existing article with the same key.
Inputs: key (required), content (required). Returns: result
removeC
Remove an article from the knowledge base by key.
Inputs: key (required). Returns: result
searchA
Semantic search across the knowledge base.
Returns up to limit articles ranked by similarity, each with key, content,
similarity (0-1, higher is better), and source file path.
Low-relevance results are automatically filtered out.
Inputs: query (required), limit. Returns: result
statusA
Show the current state of the knowledge base: number of indexed articles and watched vaults.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear and distinct purpose: index adds/replaces articles, remove deletes, search queries semantically, and status shows state. No ambiguity.
All tool names are single lowercase verbs (index, remove, search, status), following a consistent and predictable pattern.
4 tools is well-scoped for a knowledge base server, covering essential operations without being too few or too many.
The set covers add (index), delete (remove), and search, but lacks direct retrieval by key and a list-all-articles capability, which are notable gaps.
Maintenance
Related MCP Connectors
Personal context for every AI: search, read, and write back to your private Markdown library.
A search engine that learns from your grades. Store text, records, images or embeddings.
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables semantic search over local Markdown documentation using hybrid retrieval combining embeddings, keyword search, and graph traversal with automatic file watching and zero-configuration setup.2MIT
- AlicenseAqualityBmaintenanceEnables semantic search over markdown files to find related notes by meaning rather than keywords, and automatically detect duplicate content before creating new notes.32BSD 2-Clause "Simplified"
- FlicenseNot gradedqualityDmaintenanceEnables semantic search over local notes and documents using natural language queries. Supports multiple file types (Markdown, Python, HTML, JSON, CSV, text) with fast local embeddings and persistent ChromaDB vector storage.1-
- AlicenseAqualityDmaintenanceProvides semantic search and a tag-based knowledge graph for any project, auto-discovering local markdown knowledge bases with YAML frontmatter.1018 npmMIT