Overview
Features
Read Markdown notes from a directory
Reads and exposes Markdown files from a user-specified path (e.g., Obsidian vault).
Search across notes
Enables quick searching across all Markdown files within the given vault or directory.
Obsidian vault compatibility
Optimized for Obsidian vault structure while supporting any Markdown directory.
MCP client integration
Designed to work with Claude Desktop and other MCP clients via the MCP protocol.
Smithery-based installation
Can be installed automatically using the Smithery CLI (npx ... install mcp-obsidian --client claude).
VS Code integration
Provides one-click install options for VS Code and optional JSON config for manual setup.
NPX-based deployment (no global install)
Runs mcp-obsidian via NPX, avoiding a global install.
JSON-based configuration
Includes a sample VS Code mcp.json for defining inputs and server commands.
Who Is This For?
- Claude Desktop users:Users can query and search Obsidian vaults via MCP with Claude Desktop.
- MCP developers:Developers integrate this server into MCP clients to access Markdown notes.
- Obsidian enthusiasts:People using Obsidian vaults can leverage MCP to search notes.




