Obsidian Connector MCP Server

Knowledge & MemoryTypeScript

Connect Claude Desktop to read and search Obsidian vaults and Markdown notes

Available Tools

listFiles

List all files in the Obsidian vault

readFile

Read the content of a specific file in the vault

searchFiles

Search for files in the vault matching a query

The Obsidian Connector provides a seamless integration between Claude Desktop (or any MCP client) and your Markdown notes, particularly Obsidian vaults. This connector enables AI assistants to read, search, and reference your knowledge base directly. With this tool, you can leverage your existing notes and documentation while working with Claude, allowing the AI to provide more contextually relevant responses based on your personal knowledge repository. The connector works with any directory containing Markdown files, making it versatile for various note-taking systems beyond just Obsidian.

Overview

The Obsidian Connector allows Claude Desktop or any Model Context Protocol (MCP) client to access and search through your Markdown notes, particularly those stored in Obsidian vaults. This integration enables AI assistants to reference your personal knowledge base when responding to your queries.

Installation Options

Method 1: Installing via Smithery (Recommended)

The simplest way to install the Obsidian Connector is through Smithery:

Ensure you have Claude Desktop and Node.js (with npm) installed on your system

Open a terminal and run:

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

Restart Claude Desktop
You should now see the Obsidian MCP tools listed in Claude's interface

Method 2: Manual Installation

If you prefer to set up the connector manually:

Install the package globally:
```
npm install -g mcp-obsidian
```
Configure your MCP client to use the connector by adding the appropriate configuration

Method 3: VS Code Integration

For VS Code users, you can install the connector directly:

Press Ctrl + Shift + P and type Preferences: Open User Settings (JSON)
Add the MCP configuration to your settings file (see Installation JSON below)
Alternatively, create a .vscode/mcp.json file in your workspace with the configuration

Usage

Once installed, Claude Desktop will be able to:

Read files from your Obsidian vault
Search through your notes
Reference specific documents when answering your questions

When using Claude Desktop, you can ask questions like:

"Find notes about project management in my vault"
"Summarize my notes on machine learning"
"What did I write about climate change?"

The connector will search your Markdown files and provide Claude with the relevant context to answer your questions.

Configuration

The connector needs to know the path to your Obsidian vault or Markdown directory. When installing through Smithery or VS Code, you'll be prompted to provide this path.

You can point the connector to any directory containing Markdown files, not just Obsidian vaults. This makes it versatile for various note-taking systems.

Troubleshooting

If you encounter issues:

Ensure the path to your vault is correct
Check that Claude Desktop is properly restarted after installation
Verify that your Markdown files are accessible and readable
If using VS Code integration, make sure your settings JSON is correctly formatted