Obsidian MCP Server

Name: Obsidian MCP Server
Author: pmmvr

@pmmvr

Repository

About Obsidian MCP Server

MCP server enabling AI agents to perform natural knowledge discovery and analysis across Obsidian vault

#obsidian #mcp-server #knowledge-discovery

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "obsidian-api-mcp-server": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "obsidian-api-mcp-server"
      ]
    }
  }
}

Tools

Text or regex search across note content (optional)

Search type: "text" (default) or "regex"

Limit search to specific folder path

Filter by text in note titles (string, array, or JSON string)

How to match multiple terms: "any" (OR) or "all" (AND)

Filter by tag (string, array, or JSON string - searches frontmatter and inline #tags)

How to match multiple tags: "any" (OR) or "all" (AND)

Amount of content to return (set high for full content)

Boolean to retrieve complete content of all matching notes

Filter by creation date

Filter by modification date

Results per page

Limit matches per note

Directory to browse (defaults to vault root)

Boolean to include files (default: False, folders only for speed)

Boolean to browse all nested directories

Overview

What is Obsidian MCP Server?

An MCP server that enables AI agents to perform sophisticated knowledge discovery and analysis across your Obsidian vault through the Local REST API plugin. It is designed for Obsidian users who want AI assistants to query, filter, and retrieve note content for complex, multi-step workflows.

How to use Obsidian MCP Server?

Install via pip or uv (pip install obsidian-api-mcp-server), set the required environment variables (OBSIDIAN_API_URL, optionally OBSIDIAN_API_KEY), and add the server to your MCP client configuration. Run the server with obsidian-mcp. It provides three tools: search_vault, get_note_content, and browse_vault_structure.

Key features of Obsidian MCP Server

Advanced search with text, regex, and filter options
Retrieve full note content and metadata
Browse vault directory structure efficiently
Filter by folder, title, tag, and creation/modification dates
OR/AND logic for multiple title and tag terms
Context length control and pagination for large vaults

Use cases of Obsidian MCP Server

Strategic project analysis by retrieving and cross-referencing documentation
Meeting action item extraction and chronological tracking
Research gap analysis with cross-reference to team expertise
Vault structure exploration for quick organizational overview
Tag-based knowledge mapping across the entire vault

FAQ from Obsidian MCP Server

What prerequisites are needed?

Install the Obsidian Local REST API plugin in your vault, enable it, and note the API URL (default: https://localhost:27124) and API key if configured.

How do I configure authentication?

Set the OBSIDIAN_API_KEY environment variable if you have enabled an API key in the plugin. Avoid hardcoding it into scripts.

What tools does the server provide?

Three tools: search_vault (advanced search), get_note_content (retrieve full note by path), and browse_vault_structure (navigate directories).

Can I search with regular expressions?

Yes, set query_type to "regex" in search_vault. The server supports regex patterns for complex text matching, such as OR conditions.

Is SSL certificate verification disabled?

Yes, the server defaults to HTTPS and disables SSL verification for self-signed certificates. For plain HTTP, use port 27123.

Comments

More Memory & Knowledge MCP servers