{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ewnfn932snp8","handle":"obsidian-mcp-search","url":"https://wellknown.network/agents/obsidian-mcp-search","links":{"self":"https://wellknown.network/agents/obsidian-mcp-search/record.json","html":"https://wellknown.network/agents/obsidian-mcp-search","markdown":"https://wellknown.network/agents/obsidian-mcp-search/record.md","api":"https://wellknown.network/api/v1/agents/obsidian-mcp-search","status":"https://wellknown.network/api/v1/agents/obsidian-mcp-search/status","claim":"https://wellknown.network/agents/obsidian-mcp-search/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/obsidian-mcp-search/claim.json","badge":"https://wellknown.network/agents/obsidian-mcp-search/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:obsidian-mcp-search","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"obsidian-mcp-search","summary":"Self-hosted MCP server exposing embedding-powered semantic search over an Obsidian vault","description":"# obsidian-mcp-search\n\nSelf-hosted [MCP](https://modelcontextprotocol.io) server that exposes\n**embedding-powered semantic search + graph context** over your Obsidian\nvault(s). Point it at a folder of `.md` files and it serves hybrid\n(BM25 + vector + alias) search to any MCP client — with a web dashboard to\nmanage vaults and the embedding index.\n\n- No external index: walks a plain Obsidian vault directly\n- Local embeddings by default (`intfloat/multilingual-e5-small`, no API key);\n  OpenAI/Azure optional\n- Returns the matching passage **plus** heading breadcrumb, tags, aliases,\n  outbound links and backlinks\n- Multiple vaults from one server, each incrementally indexed and watched\n- Web admin dashboard at `/admin`\n\n## Install\n\n### pip / uvx\n\n```bash\npip install obsidian-mcp-search\n# Or install with the server extra (includes uvicorn + fastmcp):\npip install \"obsidian-mcp-search[server]\"\nobsidian-mcp-search add-vault main /path/to/your/vault\nobsidian-mcp-search serve\n```\n\n### One-line installer (registers an auto-start service)\n\n```bash\n./install.sh --vault /path/to/your/vault\n# macOS -> launchd, Linux -> systemd; prints dashboard URL + client config\n```\n\n### Docker\n\n```bash\necho \"VAULT_PATH=/path/to/your/vault\" > .env\ndocker compose up --build -d\n```\n\n## Connect an MCP client\n\nAdd to your client config (e.g. Claude Desktop `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"obsidian-search\": {\n      \"url\": \"http://127.0.0.1:8848/mcp\"\n    }\n  }\n}\n```\n\nTools exposed: `search(query, k, vault, mode)`, `list_vaults()`,\n`read_note(vault, path, section?)`, `reindex(vault)`.\n\n## Dashboard\n\nOpen `http://127.0.0.1:8848/admin` to add/remove vaults, reindex, clear an\nindex, switch the embedding model (re-embeds all vaults), and watch live status.\n\n**Remote dashboard note:** The `/admin` dashboard is intended for **localhost**\nuse (default: no token, works fully in a browser). Browsers cannot attach\n`Authorization: Bearer` headers to page navigations or htmx backgro…","publisher":null,"homepage":"https://github.com/KORThomasJeong/obsidian-mcp-search","repository":"https://github.com/KORThomasJeong/obsidian-mcp-search","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:obsidian-mcp-search","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"derived"},{"slug":"productivity.notes","name":"Notes & Docs","confidence":1,"provenance":"derived"},{"slug":"infra.cloud","name":"Cloud Platforms","confidence":0.768,"provenance":"derived"}],"categories":["data","infra","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"obsidian-mcp-search","registry":"pypi","observedAt":"2026-09-10T08:27:31.087Z","publishedAt":"2026-06-30T07:43:08.432300Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"obsidian-mcp-search","url":"https://pypi.org/project/obsidian-mcp-search/","firstSeenAt":"2026-09-10T08:25:56.175Z","fetchedAt":"2026-09-10T08:25:56.175Z","normalizedAt":"2026-09-10T08:25:56.175Z"}]},"firstSeenAt":"2026-09-10T08:25:56.175Z","updatedAt":"2026-09-10T08:27:31.087Z"}