An MCP server that provides a semantic search over an Obsidian vault
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":"iflow-mcp-tcsavage-obsidian-index","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 Index MCP server An MCP server that provides a semantic search over an Obsidian vault and exposes recent notes as resources. ## Components ### Resources The server exposes recently modified notes in your vaults as resources to MCP clients. - Notes are addressed by an `obsidian://<VAULT_NAME>/<NOTE_PATH>` URL scheme - Notes have the `text/markdown` media type ### Tools The server implements one tool: - `search-notes`: Performs semantic search over indexed notes ## Run the server ```bash uv run obsidian-index mcp --vault <VAULT_PATH> --database <DATABASE_PATH> --reindex --watch ``` - `--vault`: Path to the Obsidian vault (can be specified multiple times) - `--database`: Path to the local database file (will be created if it doesn't exist) - `--reindex`: Reindex all notes in the vault (you probably want this every time right now) - `--watch`: Watch for changes in the vault and update the index accordingly ## Quickstart ### Install #### Claude Desktop On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json` On Windows: `%APPDATA%/Claude/claude_desktop_config.json` <details> <summary>Development/Unpublished Servers Configuration</summary> ``` "mcpServers": { "obsidian-index": { "command": "uv", "args": [ "--directory", "<PATH_TO_PROJECT>", "run", "obsidian-index", "--database", "<PATH_TO_DATABASE>", "--vault", "<PATH_TO_VAULT>", "--reindex", "--watch" ] } } ``` </details> <details> <summary>Published Servers Configuration</summary> ``` "mcpServers": { "obsidian-index": { "command": "uvx", "args": [ "obsidian-index", "--database", "<PATH_TO_DATABASE>", "--vault", "<PATH_TO_VAULT>", "--reindex", "--watch" ] } } ``` </details> ## Development ### Building and Publishing To prepare the package for distribution: 1. Sync de…
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.