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

Dash Api Docs Mcp Server

Kapeli

MCP server for Dash, the macOS API documentation browser

167

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

Tempreon

Tempreon

Person-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.

Notion MCP Server

awkoy

Notion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.

159

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871