Happy slice of mcp pizzaMCP.pizza

mcp-obsidian

MCP.Pizza Chef: smithery-ai

mcp-obsidian is an MCP server connector designed to integrate Obsidian vaults—directories containing Markdown notes—into Claude Desktop and other MCP clients. It allows these clients to read, index, and search the contents of an Obsidian vault in real time, enhancing note retrieval and contextual AI interactions. Installation is straightforward via npm or Smithery CLI, and it supports quick setup in environments like VS Code. This server bridges the gap between powerful LLMs and personal knowledge bases stored in Obsidian, enabling efficient knowledge management and AI-assisted workflows.

Use This MCP server To

Search and retrieve notes from Obsidian vaults Integrate Obsidian notes with Claude Desktop AI workflows Enable real-time Markdown note indexing for AI models Facilitate AI-assisted knowledge management in Obsidian Provide structured context from Obsidian to LLMs

README

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}"]
      }
    }
  }
}

mcp-obsidian FAQ

How do I install mcp-obsidian?
Install via npm using 'npx @smithery/cli install mcp-obsidian --client claude' or manually with npm, then restart Claude Desktop.
Can mcp-obsidian work with MCP clients other than Claude Desktop?
Yes, it is designed to work with any MCP client that supports the protocol.
Does mcp-obsidian support real-time updates from the Obsidian vault?
It reads and indexes the vault on demand, enabling near real-time search and retrieval.
Is mcp-obsidian limited to Obsidian vaults only?
No, it can read and search any directory containing Markdown notes structured like an Obsidian vault.
What are the prerequisites for using mcp-obsidian?
You need Claude Desktop or another MCP client and npm installed on your system.
Can I use mcp-obsidian with VS Code?
Yes, there are one-click install buttons for quick setup in VS Code environments.
How does mcp-obsidian enhance AI interactions?
By providing structured, searchable context from Markdown notes, it enables LLMs like Claude, GPT-4, and Gemini to access personal knowledge bases effectively.