-
securityA
license-
qualityThis 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).
Last updated -
1,530
718
JavaScript
AGPL 3.0
The @kazuph/mcp-obsidian server enables integration of an Obsidian vault with Claude Desktop via the Model Context Protocol (MCP). It allows users to:
- Read multiple notes: Fetch contents of notes by their paths
- Search notes: Find notes by name with case-insensitive and regex support
- List directory structure: Retrieve vault organization under specified paths
- Write new notes: Create and save new notes at specified locations
Allows access to Obsidian vault content for searching, reading, listing directory structure, and creating notes
MCP Obsidian
Model Context Protocol server for Obsidian vault integration. This allows Claude Desktop (or any MCP client) to search and read your Obsidian notes.
Quick Start (For Users)
Prerequisites
- Node.js 18+ (install via
brew install node) - Obsidian vault
- Claude Desktop (install from https://claude.ai/desktop)
Configuration
- Open your Claude Desktop configuration file at:
~/Library/Application Support/Claude/claude_desktop_config.json
You can find this through the Claude Desktop menu:
- Open Claude Desktop
- Click Claude on the Mac menu bar
- Click "Settings"
- Click "Developer"
- Add the following to your configuration:
Note: Replace /path/to/your/obsidian/vault with your actual Obsidian vault path.
For Developers
Prerequisites
- Node.js 18+ (install via
brew install node) - Obsidian vault
- Claude Desktop (install from https://claude.ai/desktop)
- tsx (install via
npm install -g tsx)
Installation
Configuration
- Make sure Claude Desktop is installed and running.
- Install tsx globally if you haven't:
- Modify your Claude Desktop config located at:
~/Library/Application Support/Claude/claude_desktop_config.json
You can easily find this through the Claude Desktop menu:
- Open Claude Desktop
- Click Claude on the Mac menu bar
- Click "Settings"
- Click "Developer"
Add the following to your MCP client's configuration:
Available Tools
obsidian_read_notes: Read the contents of multiple notes. Each note's content is returned with its path as a reference.obsidian_search_notes: Search for notes by name (case-insensitive, supports partial matches and regex).obsidian_read_notes_dir: List the directory structure under a specified path.obsidian_write_note: Create a new note at the specified path.
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Obsidian vault connector for Claude Desktop - enables reading and writing Markdown notes using Model Context Protocol (MCP)
Related Resources
Related MCP Servers
- -securityFlicense-qualityProvides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.Last updated -5Python
- -securityFlicense-qualityThis project implements a Model Context Protocol (MCP) server for connecting AI models with Obsidian knowledge bases. Through this server, AI models can directly access and manipulate Obsidian notes, including reading, creating, updating, and deleting notes, as well as managing folder structures.Last updated -5987JavaScript
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.Last updated -598TypeScriptISC License