📌Overview

Purpose: The Obsidian Model Context Protocol is designed to enable the Claude Desktop (or any MCP client) to efficiently read and search directories containing Markdown notes, such as those found in an Obsidian vault.

Overview: This protocol acts as a connector, facilitating seamless integration between Claude Desktop and Markdown note directories. It allows users to leverage the capabilities of their notes for enhanced searching and reading experiences.

Key Features:

• Directory Access: Provides the ability to easily access and search through any directory containing Markdown notes, enhancing the overall utility of the notes.

• Integration with Claude Desktop: Specifically designed for use with Claude Desktop, allowing users to install and use the protocol effortlessly via Smithery.

---

Obsidian Model Context Protocol

This is a connector to allow Claude Desktop (or any MCP client) to read and search any directory containing Markdown notes (such as an Obsidian vault).

Installation

Make sure Claude Desktop and npm are installed.

Installing via Smithery

To install Obsidian Model Context Protocol for Claude Desktop automatically via Smithery:

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

Then, restart Claude Desktop and you should see the MCP tools listed.

Usage with VS Code

For quick installation, use one of the one-click install buttons below:

Install with NPX in VS Code
Install with NPX in VS Code Insiders

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

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