obsidian-mcp-for-claude-code

English

Claude Code から Obsidian Vault をファイルシステムのように扱える MCP サーバー。

Claude Code の組み込みツール（Read, Edit, Write, Glob, Grep）と同じ感覚で Obsidian Vault を操作できる。Vault へのアクセスは Obsidian 公式 CLI を経由するため、Obsidian のインデックスやリンク管理と整合性が保たれる。

Claude Code の組み込みツール（Read, Edit, Write, Bash 等）を deny にし、この MCP だけを許可することで、Obsidian Vault のみを操作するサンドボックス化されたエージェントを作れる:

// .claude/settings.json
{
  "permissions": {
    "deny": ["Read", "Edit", "Write", "Bash", "Glob", "Grep"]
    // MCP の read/write/edit 等のツールは MCP 経由で自動的に利用可能
  }
}

CLAUDE.md に以下のように記載すれば、Claude Code が組み込みツールの代わりに MCP ツールを使うようになる:

# CLAUDE.md

Obsidian Vault の操作には組み込みツールではなく、同名の MCP ツールを使うこと。
これらは組み込みツールやシェルコマンドに対応する操作を Vault 上で提供する:

| 組み込みツール / コマンド | MCP ツール |
|---|---|
| Read | mcp__obsidian__Read |
| Write | mcp__obsidian__Write |
| Edit | mcp__obsidian__Edit |
| Glob | mcp__obsidian__Glob |
| Grep | mcp__obsidian__Grep |
| mv | mcp__obsidian__mv |
| mkdir | mcp__obsidian__mkdir |
| rm | mcp__obsidian__rm |
| rmdir | mcp__obsidian__rmdir |

これにより、操作対象を Obsidian Vault に限定したエージェントが実現できる。

組み込みツールと併用すれば、コーディング中に Vault のメモを参照・更新できる。

| MCP ツール | 説明 | 対応する obsidian CLI コマンド | |---|---|---| | Read | ファイル読み取り（offset/limit 対応） | obsidian read | | Write | ファイル作成・上書き | obsidian create ... overwrite | | Edit | 文字列置換による編集 | obsidian read → 置換 → obsidian create ... overwrite | | Glob | glob パターンでファイル検索 | obsidian files + glob-match | | Grep | テキスト全文検索 | obsidian search:context | | mv | ファイルの移動・リネーム（リンク自動更新） | obsidian move | | mkdir | ディレクトリ作成 | ファイルシステム直接操作 | | rm | ファイルの削除 | obsidian delete | | rmdir | 空フォルダの削除 | ファイルシステム直接操作 |

• Obsidian が起動していること
• Obsidian CLI (obsidian コマンド) が利用可能であること — Obsidian の設定 → 一般 → CLI ツールからインストールできる
• [Rust toolchain](https: