MCP Server Obsidian Omnisearch logo

MCP Server Obsidian Omnisearch

by MCP-Mirror

This is 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?

To use this server, you need Python 3.x, Obsidian with the Omnisearch plugin installed and running, the FastMCP library, and an active Obsidian vault. After cloning the repository and installing dependencies, you can run the server with the command python server.py /path/to/your/obsidian/vault. Configure Claude Desktop to connect to the server.

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

  • Integrating Obsidian search into other applications

  • Programmatically searching Obsidian notes

  • Building tools that leverage Obsidian content

  • Automated note retrieval

  • Enhancing other services with Obsidian knowledge

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 needs to be running 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?

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

What dependencies are required?

The dependencies are FastMCP, requests, and urllib.