MCP.so
Sign In

Obsidian MCP Server

@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

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

16

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.

Frequently asked questions

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

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

pmmvr

More Memory & Knowledge MCP servers

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

RAG Documentation MCP Server

hannesrudolph

An MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.

267

Notion MCP Server

suekou

A Model Context Protocol server for connecting Notion to MCP-compatible clients

910

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

66

MemoryMesh

CheMiguel23

A knowledge graph server that uses the Model Context Protocol (MCP) to provide structured memory persistence for AI models.

348