MCP server providing sementic search over Obsidian vaults
Most planning and project tracking work still happens through a UI a human drives. Obsidian Index MCP server moves it into the conversation instead. MCP server providing sementic search over Obsidian vaults.
An MCP server that provides a semantic search over an Obsidian vault and exposes recent notes as resources.
The server publishes 4 tools. What each one is for:
search-notes — Performs semantic search over indexed notesResources — The server exposes recently modified notes in your vaults as resources to MCP clients. - Notes are addressed by anTools — The server implements one tool: - search-notes: Performs semantic search over indexed notesDebugging — Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the [MCPInstallation goes through your MCP client rather than a global install: point it at @modelcontextprotocol/inspector on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Configuration is passed through the environment: NOTE_PATH, VAULT_PATH, DATABASE_PATH, UV_PUBLISH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Obsidian Index's toolset — search-notes, Resources, Tools and 1 more — is a fair guide to whether it matches your workflow. It is maintained by tcsavage; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Obsidian Index's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| search-notes | Performs semantic search over indexed notes |
| 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 |
| Debugging | Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector). |
{
"mcpServers": {
"obsidian-index": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/inspector"],
"env": {
"NOTE_PATH": "your-value",
"VAULT_PATH": "your-value",
"DATABASE_PATH": "your-value",
"UV_PUBLISH_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| NOTE_PATH | Filesystem location the server is allowed to use. | Optional |
| VAULT_PATH | Filesystem location the server is allowed to use. | Optional |
| DATABASE_PATH | Filesystem location the server is allowed to use. | Optional |
| UV_PUBLISH_TOKEN | Credential the server authenticates with. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.