@kazuph/mcp-obsidian

local-only server

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

Integrations

  • Allows access to Obsidian vault content for searching, reading, listing directory structure, and creating notes

MCP オブシディアン

Obsidian Vault 統合用のモデルコンテキストプロトコルサーバー。これにより、Claude Desktop(または任意の MCP クライアント)で Obsidian ノートを検索および閲覧できるようになります。

クイックスタート(ユーザー向け)

前提条件

  • Node.js 18+ ( brew install nodeでインストール)
  • 黒曜石の金庫
  • Claude Desktop ( https://claude.ai/desktopからインストール)

構成

  1. Claude Desktop 構成ファイルを開きます: ~/Library/Application Support/Claude/claude_desktop_config.json

これは、Claude デスクトップ メニューから見つけることができます。

  1. クロードデスクトップを開く
  2. MacのメニューバーでClaudeをクリック
  3. 「設定」をクリック
  4. 「開発者」をクリック
  5. 設定に以下を追加します。
{ "tools": { "obsidian": { "command": "npx", "args": ["-y", "@kazuph/mcp-obsidian"], "env": { "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault" } } } }

注: /path/to/your/obsidian/vault実際の Obsidian vault パスに置き換えます。

開発者向け

前提条件

  • Node.js 18+ ( brew install nodeでインストール)
  • 黒曜石の金庫
  • Claude Desktop ( https://claude.ai/desktopからインストール)
  • tsx ( npm install -g tsxでインストール)

インストール

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

構成

  1. Claude Desktop がインストールされ、実行されていることを確認してください。
  2. まだインストールしていない場合は、tsx をグローバルにインストールします。
npm install -g tsx # or pnpm add -g tsx
  1. Claude Desktop の設定を変更してください: ~/Library/Application Support/Claude/claude_desktop_config.json

これは、Claude Desktop メニューから簡単に見つけることができます。

  1. クロードデスクトップを開く
  2. MacのメニューバーでClaudeをクリック
  3. 「設定」をクリック
  4. 「開発者」をクリック

MCP クライアントの構成に以下を追加します。

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

利用可能なツール

  • obsidian_read_notes : 複数のノートの内容を読み取ります。各ノートの内容は、パスを参照として返されます。
  • obsidian_search_notes : 名前でノートを検索します (大文字と小文字を区別せず、部分一致と正規表現をサポートします)。
  • obsidian_read_notes_dir : 指定されたパスの下のディレクトリ構造を一覧表示します。
  • obsidian_write_note : 指定されたパスに新しいノートを作成します。

You must be authenticated.

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

Claude Desktop 用の Obsidian Vault コネクタ - Model Context Protocol (MCP) を使用して Markdown ノートの読み書きを可能にします

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