home / mcp / obsidian omnisearch mcp server

Obsidian Omnisearch MCP Server

An MCP server that enables searches within Obsidian vaults using the Omnisearch plugin API. Returns absolute paths to matching notes for seamless integration. 🚀

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "anpigon-mcp-server-obsidian-omnisearch": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-server-obsidian-omnisearch",
        "run",
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

You can search Obsidian vault notes programmatically through a dedicated MCP server. It exposes a REST-like interface to query your vault and returns absolute paths to matching notes, enabling easy integration with other tools and workflows that speak MCP.

How to use

You will run the Obsidian Omnisearch MCP server locally and connect to it from an MCP client. Use the client to submit search queries and receive a list of absolute paths to notes that match your query. The server expects you to point it at your Obsidian vault when you start it, and it will handle the rest, returning results suitable for automation, dashboards, or other services.

How to install

Prerequisites you need on your machine are Python 3.x, Obsidian with the Omnisearch plugin installed and running, the FastMCP library, and an active Obsidian vault.

# Option 1: Install via Smithery (automatic)
# Run this on your machine to install the MCP server for Claude Desktop
npx -y @smithery/cli install @anpigon/mcp-server-obsidian-omnisearch --client claude
```

```bash
# Option 2: Manual installation
# Step 1: Clone the repository
git clone https://github.com/anpigon/mcp-server-obsidian-omnisearch.git
cd mcp-server-obsidian-omnisearch

# Step 2: Install dependencies
uv install
```

```
# Configure the vault path when you run the server
python server.py /path/to/your/obsidian/vault

Configuration and runtime details

Start the server by pointing it to your Obsidian vault. This is the runtime path you provide when launching the server.

The following MCP configurations are provided for both unpublished and published server setups. Use the appropriate one for your environment.

{
  "mcpServers": {
    "obsidian_omnisearch_unpublished": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-server-obsidian-omnisearch",
        "run",
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

{
  "mcpServers": {
    "obsidian_omnisearch_published": {
      "command": "uvx",
      "args": [
        "mcp-server-obsidian-omnisearch",
        "/path/to/your/obsidian/vault"
      ]
    }
  }
}

Available tools

obsidian_notes_search

Searches Obsidian notes and returns absolute paths to matching notes. Takes a query string and returns a list of paths to notes that match the query.

server_run

Launches the MCP server pointed at a specific Obsidian vault path and exposes the search API to MCP clients.