Obsidian MCP Server

What it does

This server integrates Obsidian vaults directly with AI agents, allowing them to read, write, and analyze your second brain. It goes beyond simple file access by providing deep graph analytics and semantic search capabilities via plugin integrations.

Tools

• list_files_in_vault: Explore the entire vault structure.
• get_file_contents: Read specific notes to provide context.
• put_content / append_content: Update or expand your notes autonomously.
• get_vault_stats: Analyze note counts, links, and orphans.
• detect_note_clusters: Use community detection to find related themes in your knowledge graph.
• semantic_search: Perform conceptual searches using the Smart Connections plugin.
• execute_command: Trigger Obsidian internal commands directly from the AI.

Installation

Install via npm:

npm install -g @connorbritain/obsidian-mcp-server

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@connorbritain/obsidian-mcp-server"],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key",
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

Supported hosts

• claude
• windsurf
• cursor