MCP Server Obsidian Omnisearch

🚀 MCP Server Obsidian Omnisearch

A FastMCP-based server that provides Obsidian vault search functionality through a REST API.

🚀 Quick Start

This project implements a search service that allows you to programmatically search in Obsidian vault notes. It uses FastMCP to expose the search functionality as a tool for integration with other services.

✨ Features

• Search in Obsidian vault notes.
• Integrate with REST API.
• Return the absolute paths of matching notes.
• Easily integrate with the FastMCP tool.

📦 Installation

Prerequisites

• Python 3.x
• The Obsidian Omnisearch plugin installed and running
• The FastMCP library
• An active Obsidian vault

Automatic Installation via Smithery

Automatically install the MCP Server Obsidian Omnisearch for Claude Desktop through Smithery:

npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch

2. Install the dependencies:

uv install

📚 Documentation

Configuration

The Obsidian vault path is now provided as a command-line argument when running the server:

python server.py /path/to/your/obsidian/vault

Usage

Obsidian Omnisearch API

You need the Obsidian Omnisearch community plugin to be running: https://publish.obsidian.md/omnisearch/Inject+Omnisearch+results+into+your+search+engine

Claude Desktop

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"
      ]
    }
  }
}

🔧 Technical Details

Dependencies

• FastMCP
• requests
• urllib

📄 License

This project is released under the MIT License - see the LICENSE file for details.

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.