Spark
Sign In
MCP Connector

Connect Obsidian Notes to Claude Desktop

Read and search any Markdown notes directory - including an Obsidian vault - directly from Claude Desktop or another MCP client.

Connect
Works with obsidianclaudevscode
Henry Mao
Own this? Claim it

Maintainer of this project? Claim this page to edit the listing.

90
Spark score
out of 100
Updated 5 months ago
Version 1.0.0
Models
universal
Add to Favorites

Why it matters

Integrate your Obsidian vault with Claude Desktop to enable powerful search and summarization capabilities across your Markdown notes.

Outcomes

What it gets done

01

Read and index Markdown notes from any directory.

02

Search across the full content of your Obsidian vault.

03

Leverage Claude Desktop's AI for advanced note analysis.

04

Seamlessly connect your existing Markdown knowledge base.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-obsidian-markdown-notes | bash

Capabilities

Tools your agent gets

read_markdown_notes

Read Markdown notes from any directory or Obsidian vault

search_vault

Search across Obsidian vault contents and Markdown files

Overview

Obsidian Markdown Notes MCP Server

mcp-obsidian lets Claude Desktop or any MCP client read and search a directory of Markdown notes, such as an Obsidian vault, at the file-content level without requiring an Obsidian plugin. Use it when an AI assistant needs to read or search Markdown notes from a vault or folder. Not applicable for Obsidian-specific features like backlinks or graph view.

What it does

mcp-obsidian is a connector that lets Claude Desktop or any MCP client read and search a directory of Markdown notes, such as an Obsidian vault, without needing Obsidian's own plugin system.

When to use - and when NOT to

Use it when you want an AI assistant to browse and search your personal notes - an Obsidian vault or simply any folder of .md files - to answer questions or pull context from your notes into a conversation. It works with any directory containing Markdown files, not exclusively Obsidian-managed ones. Do not use it expecting Obsidian-specific features like backlinks, graph view, or plugin data - it operates purely at the filesystem/Markdown level, reading and searching file contents.

Capabilities

  • Read Markdown notes from any specified directory.
  • Search across the contents of a vault or notes folder.
  • Compatible with Claude Desktop and any other MCP-compatible client.

How to install

Install automatically for Claude via Smithery:

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

Or run directly, passing your vault path:

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

VS Code configuration (user settings or .vscode/mcp.json):

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

Requires Claude Desktop and npm installed; restart Claude Desktop after Smithery installation to see the new tools. VS Code and VS Code Insiders support one-click install buttons.

Who it's for

Obsidian users and anyone maintaining a folder of Markdown notes who wants an AI assistant to read and search that content directly, without exporting or copy-pasting notes into the conversation.

Source README

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.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.