Obsidian MCP Server

What it does

Obsidian MCP Server connects your Obsidian vault to any MCP-compatible AI agent. The agent can search notes by keyword, read full documents, list vault contents, and build long-context memory packets — all with configurable token limits to keep API costs under control. It also automates frontmatter management and can organize image attachments.

Tools

• vault (action: search) — keyword-based note search with configurable result limit
• vault (action: read) — read a specific note by filename
• vault (action: list_all) — list all documents in the vault
• vault (action: stats) — vault health check: total files, init status, vault path
• vault (action: collect_context) — build a compressed memory packet from multiple notes for long-context use
• vault (action: load_memory) — retrieve saved memory notes
• generate_property — suggest frontmatter properties for a document
• write_property — write generated frontmatter back to the document
• create_document_with_properties — create a new note with auto-generated frontmatter
• organize_attachments — move and re-link image attachments into per-document subfolders

Installation

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@sunub/obsidian-mcp-server@latest"],
      "env": {
        "VAULT_DIR_PATH": "/absolute/path/to/your/vault",
        "LOGGING_LEVEL": "info"
      }
    }
  }
}

Requires Node.js 22+. VAULT_DIR_PATH must be an absolute path.

Supported hosts

Claude Desktop, VS Code Copilot, Cursor, Codex, Gemini CLI (all confirmed in README)