A connector that allows Claude Desktop (or any MCP client) to read and search any directory with Markdown notes, such as an Obsidian vault.

Installation

Smithery

npx -y @smithery/cli install mcp-obsidian --client claude

NPX Direct

npx -y mcp-obsidian ${input:vaultPath}

Configuration

VS Code User Settings

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "vaultPath",
        "description": "Path to Obsidian vault"
      }
    ],
    "servers": {
      "obsidian": {
        "command": "npx",
        "args": ["-y", "mcp-obsidian", "${input:vaultPath}"]
      }
    }
  }
}

VS Code Workspace (.vscode/mcp.json)

{
  "inputs": [
    {
      "type": "promptString",
      "id": "vaultPath",
      "description": "Path to Obsidian vault"
    }
  ],
  "servers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian", "${input:vaultPath}"]
    }
  }
}

Capabilities

• Read Markdown notes from any directory
• Search across Obsidian vault contents
• Compatible with Claude Desktop and any MCP client
• Works with any directory containing Markdown files

Notes

Requires Claude Desktop and npm to be installed. After installation via Smithery, restart Claude Desktop to see MCP tools in the list. Supports both VS Code and VS Code Insiders with one-click installation buttons.