MCP Server Obsidian Omnisearch
@anpigon
An MCP server that enables searches within Obsidian vaults using the Omnisearch plugin API. Returns absolute paths to matching notes for seamless integration. 🚀
Overview
What is MCP Server Obsidian Omnisearch?
MCP Server Obsidian Omnisearch is a FastMCP-based server that provides programmatic search functionality for Obsidian vault notes through a REST API interface. It is designed for developers and power users who want to integrate Obsidian vault searches into other tools or workflows.
How to use MCP Server Obsidian Omnisearch?
The server can be installed via Smithery or manually using uv. After installation, run the server with the path to your Obsidian vault as a command-line argument (e.g., python server.py /path/to/vault). Configure it as an MCP tool in an application like Claude Desktop by adding the appropriate configuration to claude_desktop_config.json. The server exposes a single tool, obsidian_notes_search(query), which returns absolute paths to matching notes.
Key features of MCP Server Obsidian Omnisearch
- Searches Obsidian vault notes programmatically
- Returns absolute file paths of matching notes
- Integrates with any FastMCP-compatible client
- Requires Obsidian's Omnisearch plugin to be running
- Can be installed via Smithery or manually with
uv
Use cases of MCP Server Obsidian Omnisearch
- Automate retrieval of notes from an Obsidian vault
- Integrate Obsidian search into AI assistants like Claude
- Build custom search tools that query Obsidian notes
FAQ from MCP Server Obsidian Omnisearch
What are the prerequisites for using this server?
Python 3.x, an active Obsidian vault with the Omnisearch plugin installed and running, and the FastMCP library.
How do I specify my Obsidian vault path?
Provide the absolute path to your vault as a command-line argument when starting the server.
What dependencies does the server require?
It requires FastMCP, requests, and urllib libraries.
How can I debug the server?
Use the MCP Inspector by running npx @modelcontextprotocol/inspector with the appropriate uv command, or watch server logs using tail.
What license is this project under?
The project is licensed under the MIT License.
