Semantic search for Obsidian vaults via MCP
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"obsidian-rag-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Obsidian RAG MCP Server **Your notes, searchable by meaning.** An MCP server that gives Claude Code semantic search over your Obsidian vault. Ask questions in natural language, get answers from your own documents. [](https://github.com/danielscholl/obsidian-rag-mcp/actions/workflows/ci.yml) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) --- ## The Problem You have 500 notes in Obsidian. You know you wrote something about database timeouts causing customer issues... somewhere. Ctrl+F won't help when you don't remember the exact words. ## The Solution This server indexes your vault with vector embeddings. Ask for "RCAs where database timeouts caused customer-facing issues" and get results even if your notes use terms like "CosmosDB latency", "connection pool exhaustion", or "query timeout." Semantic search. Vectors stored locally. Sub-second queries. --- ## Quick Start ```bash # Clone and install (using uv - recommended) git clone https://github.com/danielscholl/obsidian-rag-mcp.git cd obsidian-rag-mcp uv sync # Set your API key export OPENAI_API_KEY="sk-..." # Index the sample vault (or your own) uv run obsidian-rag index --vault ./vault # Search it uv run obsidian-rag search "database connection issues" --vault ./vault ``` <details> <summary>Output</summary> ``` Query: database connection issues Found 3 results (searched 1154 chunks) --- Result 1 (score: 0.480) --- Source: RCAs/2025-05-17-database-connection-pool-exhaustion.md Tags: database, p1, rca # 2025-05-17 - Database Connection Pool Exhaustion in payment-gateway... --- Result 2 (score: 0.466) --- Source: RCAs/2025-06-18-database-connection-po…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.