obsidian-mcp

Claude（およびあらゆるMCPクライアント）に、Obsidianボルトへの真のエージェントアクセス権（グラフ探索、Dataviewクエリ、デイリーノートの認識など）を提供します。

インストール · ツール · 試すべきプロンプト · 比較 · FAQ

ほとんどのObsidian MCPサーバーは read_file と write_file を提供するだけで終わっています。このサーバーはあなたのボルトをナレッジグラフとして扱います。LLMは、バックリンク、フォワードリンク、Dataviewクエリ、デイリーノート、そしてマルチホップのグラフ探索を単一の呼び出しで実行できます。

なぜこれが必要か

Claude Desktopを開き、ノート内のつながりを見つけるよう依頼すると、read_file を使ってボルト内のノートを1つずつ読み込んでいく様子を目にしたことがあるでしょう。しかし、Obsidianユーザーはノートをそのようには考えていません。グラフこそが価値であり、バックリンク、推移的なつながり、タグ、Dataviewで型付けされたメタデータが重要です。このサーバーは、それらすべてをファーストクラスのツールとして提供します。

インストール

Obsidianで Local REST API プラグインが必要です。コミュニティプラグインからインストールして有効にし、設定からAPIキーをコピーしてください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に以下を追加します：

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp"],
      "env": {
        "OBSIDIAN_API_KEY": "paste-your-key-here"
      }
    }
  }
}

Claude Desktopを再起動してください。これで完了です。

Claude Code

claude mcp add obsidian -e OBSIDIAN_API_KEY=paste-your-key-here -- npx -y obsidian-mcp

Cursor / Cline / Continue / Zed

MCP互換クライアントであればどれでも動作します。環境変数に OBSIDIAN_API_KEY を設定し、npx -y obsidian-mcp を指定してください。

ソースからインストール

git clone https://github.com/yanxue06/obsidian-mcp.git
cd obsidian-mcp
npm install
npm run build
OBSIDIAN_API_KEY=... node dist/index.js

試すべきプロンプト

サーバーを接続した状態で、Claude Desktopに以下のプロンプトを試してみてください：

分散システムについて書いたすべての内容のコンテンツマップ（MOC）を作成してください。「Distributed systems.md」から traverse_graph を深さ2で使用し、近傍のノートをテーマごとにグループ化して、MOCs/Distributed systems MOC.md に書き出してください。

#project タグが付いており、status != "done" で、期限が今週であるすべてのノートを見つけてください。query_dataview を使用してください。

今日のデイリーノートには何が書かれていますか？昨日のノートからフォローアップし忘れていることはありますか？

Inbox/ 内の孤立したノート（orphan notes）をすべて見つけてください。それぞれの内容と既存のタグに基づいて、どこに分類すべきか提案してください。

「Atomic notes.md」を「Evergreen notes.md」にリネームします。リンクしているすべてのノートを見つけて、更新が必要なものを教えてください。

「Working memory.md」からグラフを2ホップ分探索し、注意（attention）に関する私の考えの中心となっているノートを教えてください。

ツール

合計15個のツールがあります。差別化されたツールは太字で示しています。

読み取り

検索とグラフ

書き込み

比較

設定

すべての設定は環境変数経由で行います。MCPクライアントの設定で指定してください。

仕組み

┌──────────────┐     stdio (MCP)      ┌──────────────┐    HTTPS     ┌──────────────────┐
│ Claude / IDE │ ───────────────────► │ obsidian-mcp │ ───────────► │  Local REST API  │ ──► Vault
└──────────────┘                      └──────────────┘              │ (Obsidian plugin)│
                                                                    └──────────────────┘

obsidian-mcp は Local REST APIプラグイン 上の薄いレイヤーです。このプラグインはObsidian内でHTTPSサーバーを動かし、ボルトへのフルアクセスを提供します。このサーバーは、そのインターフェースをMCPプロトコルに適応させ、ObsidianのREST APIが直接提供していないグラフ認識ツール（バックリンク、マルチホップ探索、孤立ノート検出など）を追加します。

すべてローカルで完結します。MCPクライアントがモデルプロバイダーに対して行うリクエスト以外、データがマシンから外部へ送信されることはありません。その制御はあなたが行います。

FAQ

Obsidianプラグインをインストールする必要がありますか？ はい、Local REST APIプラグインが必要です。外部から実行中のボルトと通信するための唯一の現実的な方法です。インストール後、obsidian-mcp 自体はMCPクライアントによって起動される別のNodeプロセスとして動作するため、Obsidianに追加のプラグインをインストールする必要はありません。

Obsidianが閉じていると動作しませんか？ はい。Local REST APIはObsidianの「内部」で動作するため、アプリを開いておく必要があります。

複数のボルトをサポートしていますか？ 1つのサーバーインスタンスは、1つの実行中のObsidianインスタンスを指します。頻繁にボルトを切り替える場合は、複数のMCPサーバーエントリ（異なる名前とポート）を実行してください。

なぜ OBSIDIAN_VERIFY_TLS=false でHTTPSがデフォルトなのですか？ プラグインには自己署名証明書が同梱されています。通信はループバック（127.0.0.1）のみであるため、検証を行ってもセキュリティ上の実質的なメリットはなく、手間が増えるだけだからです。証明書を置き換えた場合は、フラグを有効にしてください。

これは安全ですか？ MCPサーバーは、APIキーが許可する範囲のアクセス権をモデルに与えます。モデルが削除しようとすれば、何でも削除可能です。ファイル書き込み権限を持つ他のエージェントと同様に扱い、特に一括操作の前には、実行しようとしている内容を確認してください。

ロードマップ

• [ ] 埋め込みベースのセマンティック検索（現在はプラグイン経由のキーワード検索のみ）

• [ ] ワークスペース切り替え / マルチボルトルーティング

• [ ] 読み取り専用セーフモード（書き込みツールを登録しない）

• [ ] リソースサブスクリプション（ノート変更時のプッシュ更新）

• [ ] Smithery / mcp-get レジストリへの登録

プルリクエストを歓迎します。CONTRIBUTING.md を参照してください。

謝辞

• Local REST API by @coddingtonbear — このプロジェクト全体がこのプラグインの恩恵を受けています。

• Anthropicの Model Context Protocol チーム。

ライセンス

MIT — LICENSE を参照してください。