Obsidian MCP

obsidian-mcp

あらゆる Obsidian Vault を AI がクエリできるナレッジグラフに変える MCP サーバーです。

既存の 24 以上の Obsidian MCP サーバーとの違い：

• グラフ優先 — [[wikilinks]] による BFS、最短経路、連結成分、橋の検出
• インフラ不要 — データベース、Obsidian の実行、API キーは不要です
• Vault を選ばない — 既存のあらゆる Vault で動作し、特定の構造も必要ありません
• バックリンクを考慮した書き込み — move_note は Vault 全体のすべての参照を自動更新します
• 軽量 — ランタイム依存関係は 4 つ、バンドルサイズは約 42KB です

クイックスタート

npx obsidian-mcp --vault ~/my-obsidian-vault

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp", "--vault", "/path/to/vault"]
    }
  }
}

Claude Code

claude mcp add obsidian -- npx -y obsidian-mcp --vault /path/to/vault

ツール（12）

読み取りと探索

ツール	説明
vault_stats	概要：ノート、タグ、リンク、孤立ノート、連結成分の合計数、上位のタグ／ハブ
read_note	全文、フロントマター、リンク、バックリンク、セクション
search_notes	タグ、フォルダー、フロントマター、キーワードで絞り込み。すべて組み合わせ可能

グラフの探索

ツール	説明
graph_neighbors	ノートへの直接リンクとバックリンク
graph_traverse	タグで絞り込みながら、ノートから N ホップの深さまで BFS／DFS で探索
graph_shortest_path	2 つのノート間の最短リンクチェーン
graph_analyze	連結成分、孤立ノート、橋、ハブ、リンク切れ

書き込みと操作

ツール	説明
create_note	コンテンツとフロントマターを指定して作成
patch_note	セクションの末尾への追加、先頭への追加、置換。フロントマターの更新
move_note	名前変更／移動と、Vault 全体のすべてのバックリンクの自動更新
delete_note	削除とリンク切れの報告
manage_tags	タグの追加／削除／名前変更（Vault 全体での名前変更に対応）

設定

デフォルトでは設定不要です。必要に応じて Vault のルートに .obsidian-mcp.json を配置します。

{
  "ignore": ["templates/", "daily-notes/", ".trash/"],
  "watchDebounce": 100,
  "maxTraversalDepth": 10,
  "maxSearchResults": 500
}

CLI フラグ

--vault <path>       Path to Obsidian vault (required)
--verbose            Enable debug logging
--log-level <level>  error | warn | info | debug (default: info)

仕組み

1. 起動時にすべての .md ファイルをスキャンし、メモリ内グラフを構築します（ノート 1,000 件で約 1～3 秒）
2. ファイルウォッチャーが変更を検出し、グラフを段階的に更新します（変更 1 件あたり約 5 ミリ秒）
3. Claude は MCP ツールを通じてグラフにクエリします。再スキャンは不要です
4. 書き込み操作では、ファイルシステムとグラフの両方をアトミックに更新します

ハードコードされた除外対象：.obsidian/、.trash/、node_modules/

開発

npm install
npm test              # Run 66 tests
npm run build         # Build to dist/
npm run dev -- --vault test/fixtures/vault  # Dev mode

ライセンス

MIT