CF

Connector for Claude Desktop to read and search Markdown notes in Obsidian vaults.

Created 3 months ago

Connector for Claude Desktop to read and search Markdown notes in Obsidian vaults.

development documentation public

What is Connector for Claude Desktop to read and search Markdown notes in Obsidian vaults.?

Obsidian Model Context Protocol is a connector that allows Claude Desktop (or any MCP client) to read and search any directory containing Markdown notes, such as an Obsidian vault. It can be installed via Smithery or manually configured in VS Code.

Documentation

Obsidian Model Context Protocol

smithery badge

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 is 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 following MCP tools listed:

image

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. This will allow you 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}"]
      }
    }
  }
}

Server Config

{
  "mcpServers": {
    "connector-for-claude-desktop-to-read-and-search-markdown-notes-in-obsidian-vaults.-server": {
      "command": "npx",
      "args": [
        "connector-for-claude-desktop-to-read-and-search-markdown-notes-in-obsidian-vaults."
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Aug 08, 2025
Updated At: Aug 08, 2025
Author: Calclavia
Category: MCP Connectors
License: MIT
Tags:
development documentation public