MCP Server Obsidian Omnisearch

Source

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

Catalog onlyCatalog onlySTDIO

Overview

MCP Server Obsidian Omnisearch is a FastMCP-based server that provides programmatic search functionality through the REST API for notes in an Obsidian vault. It allows users to efficiently search and retrieve notes based on query strings.

To use the server, clone the repository from GitHub, install the required dependencies, and run the server with the path to your Obsidian vault. The API can then be accessed following the setup of the Obsidian Omnisearch plugin.

Programmatic search capability for Obsidian vault notes. - REST API integration for seamless use in other applications. - Returns absolute paths to notes matching the search query. - Easy integration with FastMCP tools for extended functionality.

Searching for specific notes in a large Obsidian vault.
Integrating Obsidian notes search into custom applications or workflows.
Enhancing note organization and retrieval in personal knowledge management systems.

Add to your AI client

Use these steps to connect MCP Server Obsidian Omnisearch in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-obsidian-omnisearch-anpigon": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-obsidian-omnisearch-anpigon"
      ]
    }
  }
}

FAQ

What are the prerequisites for using MCP Server Obsidian Omnisearch?

You need Python 3.x, the Obsidian Omnisearch plugin, the FastMCP library, and an active Obsidian vault.

Can I run the server on any operating system?

Yes, the server can be run on any OS that supports Python and has access to the required libraries.

How can I debug issues while using the server?

Use the MCP Inspector for a better debugging experience and to monitor server logs.

Research and data