Obsidian Omnisearch
About
Integrates Obsidian vaults to enable searching and retrieving notes, leveraging personal knowledge for various applications.
Details
- Author
- anpigon
- Repository
- anpigon/mcp-server-obsidian-omnisearch
- GitHub stars
- 14
- Downloads
- 6,789
- License
- MIT License
- Categories
- Search, Knowledge Base, Other, AI, Design, Developer Tools, API, Frontend
- Tags
- #integration
Jump to
- Search through Obsidian vault notes
- REST API integration
- Returns absolute paths to matching notes
- Easy integration with FastMCP tools
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Obsidian OmnisearchCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
<dir_to>/mcp-server-obsidian-omnisearch -
Argument 3
run -
Argument 4
mcp-server-obsidian-omnisearch -
Argument 5
/path/to/your/obsidian/vault
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install MCP Server Obsidian Omnisearch for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude
1. Clone the repository:
git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch
2. Install dependencies:
uv install
obsidian_notes_search
Searches Obsidian notes and returns absolute paths to matching notes. Parameters: query (string)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"obsidian omnisearch": {
"env": {},
"args": [
"--directory",
"<dir_to>/mcp-server-obsidian-omnisearch",
"run",
"mcp-server-obsidian-omnisearch",
"/path/to/your/obsidian/vault"
],
"shell": false,
"command": "uv"
}
}
}Linux
{
"env": [],
"args": [
"--directory",
"<dir_to>/mcp-server-obsidian-omnisearch",
"run",
"mcp-server-obsidian-omnisearch",
"/path/to/your/obsidian/vault"
],
"shell": false,
"command": "uv"
}Macos
{
"env": [],
"args": [
"--directory",
"<dir_to>/mcp-server-obsidian-omnisearch",
"run",
"mcp-server-obsidian-omnisearch",
"/path/to/your/obsidian/vault"
],
"shell": false,
"command": "uv"
}Windows
{
"env": [],
"args": [
"mcp-server-obsidian-omnisearch",
"/path/to/your/obsidian/vault"
],
"shell": false,
"command": "uvx"
}This project implements a search service that allows you to search through Obsidian vault notes programmatically. It uses FastMCP to expose the search functionality as a tool that can be integrated with other services.
- Search through Obsidian vault notes
- REST API integration
- Returns absolute paths to matching notes
- Easy integration with FastMCP tools
- Python 3.x
- Obsidian with Omnisearch plugin installed and running
- FastMCP library
- Active Obsidian vault
To install MCP Server Obsidian Omnisearch for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude
git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git cd mcp-server-obsidian-omnisearch
The Obsidian vault path is now provided as a command line argument when running the server:
python server.py /path/to/your/obsidian/vault
You need the Obsidian Omnisearch community plugin running:https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine
On MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows:%APPDATA%/Claude/claude_desktop_config.json
{ "mcpServers": { "obsidian-omnisearch": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-server-obsidian-omnisearch", "run", "mcp-server-obsidian-omnisearch", "/path/to/your/obsidian/vault" ] } } }
{ "mcpServers": { "obsidian-omnisearch": { "command": "uvx", "args": [ "mcp-server-obsidian-omnisearch", "/path/to/your/obsidian/vault" ] } } }
- Function:obsidian_notes_search(query: str)
- Description: Searches Obsidian notes and returns absolute paths to matching notes
- Parameters:
- query: Search query string
To prepare the package for distribution:
This will create source and wheel distributions in thedist/directory.
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:--tokenorUV_PUBLISH_TOKEN
- Or username/password:--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using theMCP Inspector.
You can launch the MCP Inspector vianpmwith this command:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-obsidian-omnisearch run mcp-server-obsidian-omnisearch
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
You can also watch the server logs with this command:
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-server-obsidian-omnisearch.log
This project is licensed under the MIT License - see theLICENSEfile for details.
Contributions are welcome! Please feel free to submit a Pull Request.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
MCP server for Apple Notes with semantic search and CRUD operations. Claude searches, reads, creates, updates, and manages your Apple Notes through natural language.
A local server to query and interact with Markdown knowledge bases by tags, text, slug, or date.
Self-hosted MCP server for Obsidian: semantic + full-text search, wikilink graph, note CRUD, OAuth, and a self-describing vault guide.
A server for the Scrapbox/CoSense platform to retrieve, list, search, and create pages.
This MCP (Model Context Protocol) server provides integration with Wiki.JS for searching and listing pages from Agent Voice Response Wiki.JS instance.
Fetch, convert, and search AWS documentation pages, with recommendations for related content.
Production-ready RAG out of the box to search and retrieve data from your own documents.
Quran-focused MCP server for ayah translation, tafsir, mutashabihat lookups, recitation playlists, and prayer times.
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
Provides AI assistants with intelligent access to ML textbook content for creating accurate, source-grounded documentation.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
