Skip to main content
Glama
Sign In
enesjakozh

@kazuph/mcp-obsidian

by kazuph
npmGitHub
JavaScript
MIT License
36
3
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • 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

Configuration

  1. Open your Claude Desktop configuration file at: ~/Library/Application Support/Claude/claude_desktop_config.json

You can find this through the Claude Desktop menu:

  1. Open Claude Desktop
  2. Click Claude on the Mac menu bar
  3. Click "Settings"
  4. Click "Developer"
  5. Add the following to your configuration:
{ "tools": { "obsidian": { "command": "npx", "args": ["-y", "@kazuph/mcp-obsidian"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

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

git clone https://github.com/kazuph/mcp-obsidian.git cd mcp-obsidian npm install npm run build

Configuration

  1. Make sure Claude Desktop is installed and running.
  2. Install tsx globally if you haven't:
npm install -g tsx # or pnpm add -g tsx
  1. 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:

  1. Open Claude Desktop
  2. Click Claude on the Mac menu bar
  3. Click "Settings"
  4. Click "Developer"

Add the following to your MCP client's configuration:

{ "tools": { "obsidian": { "args": ["tsx", "/path/to/mcp-obsidian/index.ts"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

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.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Obsidian vault connector for Claude Desktop - enables reading and writing Markdown notes using Model Context Protocol (MCP)

  1. Quick Start (For Users)
    1. Prerequisites
    2. Configuration
  2. For Developers
    1. Prerequisites
  3. Installation
    1. Configuration
      1. Available Tools

        Related Resources

        Related MCP Servers

        • Obsidian

          smithery-ai
          -
          security
          A
          license
          -
          quality
          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).
          Last updated -
          1,530
          718
          JavaScript
          AGPL 3.0

        • Obsidian Index MCP Server

          tcsavage
          -
          security
          F
          license
          -
          quality
          Provides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.
          Last updated -
          5
          Python

        • Obsidian MCP

          newtype-01
          -
          security
          F
          license
          -
          quality
          This 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 -
          598
          7
          JavaScript

        • Obsidian MCP

          takuya0206
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants to read, write, and manipulate notes in your Obsidian vault through a standardized interface.
          Last updated -
          598
          TypeScript
          ISC License

        View all related MCP servers

        Appeared in Searches

        New MCP Servers

        ID: sed8z2tqq9