Obsidian MCP Server

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

Local serverstdioPython

What is the Obsidian MCP Server?

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

The short version

An MCP (Model Context Protocol) server that enables AI agents to perform sophisticated knowledge discovery and analysis across your Obsidian vault through the Local REST API plugin.

  • "Retrieve notes from my 'Projects/Planning' folder containing 'roadmap' or 'timeline' in titles, created after April 1st, then analyze them for any blockers or dependencies and present a consolidated risk assessment with references to the source notes" —
  • "Find all notes tagged with 'research' or 'analysis' from the last month, scan their content for incomplete sections or open questions, then cross-reference with my 'Team/Expertise' notes to suggest which colleagues could help address each gap" —
  • "Get the complete content of meeting notes from 'Leadership/Quarterly' containing 'budget' or 'headcount', analyze them for action items assigned to my department, and create a chronological timeline with source note references" —

What it needs from you

  1. Install the Obsidian Local REST API plugin in your Obsidian vault 2. Configure and enable the plugin in Obsidian settings 3. Note the API URL (default: https://localhost:27124) and API key if you've set one

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
queryText or regex search across note content (optional)
query_typeSearch type: "text" (default) or "regex"
search_in_pathLimit search to specific folder path
title_containsFilter by text in note titles (string, array, or JSON string)
title_match_modeHow to match multiple terms: "any" (OR) or "all" (AND)
tagFilter by tag (string, array, or JSON string - searches frontmatter and inline #tags)
tag_match_modeHow to match multiple tags: "any" (OR) or "all" (AND)
context_lengthAmount of content to return (set high for full content)
include_contentBoolean to retrieve complete content of all matching notes
page_sizeResults per page
max_matches_per_fileLimit matches per note
pathDirectory to browse (defaults to vault root)
include_filesBoolean to include files (default: False, folders only for speed)
recursiveBoolean to browse all nested directories

How to install the Obsidian MCP Server

{
  "mcpServers": {
    "obsidian-api": {
      "command": "uvx",
      "args": ["obsidian-api-mcp-server"],
      "env": {
        "OBSIDIAN_API_URL": "your-value",
        "OBSIDIAN_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  1. Install the Obsidian Local REST API plugin in your Obsidian vault 2. Configure and enable the plugin in Obsidian settings 3. Note the API URL (default: https://localhost:27124) and API key if you've set one
VariableDescriptionRequired
OBSIDIAN_API_URLEndpoint or connection string the server talks to.Yes
OBSIDIAN_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Obsidian to query.”
  • “Use Obsidian to query type.”
  • “Use Obsidian to search in path.”

Frequently asked questions

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.