MCP Server Obsidian Omnisearch logo

MCP Server Obsidian Omnisearch

by anpigon

A FastMCP-based server that provides Obsidian vault search functionality through a REST API interface. It allows you to search through Obsidian vault notes programmatically.

View on GitHub

Last updated: N/A

What is MCP Server Obsidian Omnisearch?

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.

How to use MCP Server Obsidian Omnisearch?

  1. Install via Smithery or manually by cloning the repository and installing dependencies using uv install. 2. Configure the Obsidian vault path as a command-line argument when running the server: python server.py /path/to/your/obsidian/vault. 3. Ensure the Obsidian Omnisearch plugin is installed and running. 4. Configure Claude Desktop with the appropriate server command and arguments.

Key features of MCP Server Obsidian Omnisearch

  • Search through Obsidian vault notes

  • REST API integration

  • Returns absolute paths to matching notes

  • Easy integration with FastMCP tools

Use cases of MCP Server Obsidian Omnisearch

  • Programmatically searching Obsidian notes

  • Integrating Obsidian search with other services

  • Automating note retrieval

  • Building tools that leverage Obsidian content

FAQ from MCP Server Obsidian Omnisearch

What is FastMCP?

FastMCP is a library used to expose the search functionality as a tool that can be integrated with other services.

What is the Obsidian Omnisearch plugin?

The Obsidian Omnisearch plugin is a community plugin that allows you to inject Omnisearch results into your search engine.

How do I configure the server?

The Obsidian vault path is provided as a command-line argument when running the server: python server.py /path/to/your/obsidian/vault.

How do I debug the server?

For the best debugging experience, use the MCP Inspector. You can launch it via npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-obsidian-omnisearch run mcp-server-obsidian-omnisearch.

What are the dependencies?

The dependencies are FastMCP, requests, and urllib.