/ ディレクトリ / プレイグラウンド / Obsidian MCP Server
● コミュニティ cyanheads 🔑 自分のキーが必要

Obsidian MCP Server

作者 cyanheads · cyanheads/obsidian-mcp-server

Obsidian ボールトをファーストクラスの MCP リソースにします。メモ、タグ、フロントマター、ローカル REST API プラグインを介したグローバル検索のための 8 つのツールです。

yanheads/obsidian-mcp-server は、Obsidian Local REST API コミュニティ プラグインを介して、任意の MCP クライアント (Claude Desktop、Cursor、Cline、Windsurf) を Obsidian ボールトにブリッジします。 エージェントは、Obsidian を開くことなく、メモの読み取り/上書き、追加/先頭/上書きモード、アトミックなフロントマター編集、タグ管理、フルボルト検索をすべて利用できます。 高速に繰り返されるクエリのために、解析されたメタデータをキャッシュします。

なぜ使うのか

主な機能

ライブデモ

実際の動作

obsidian-mcp-server.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-mcp-server",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-server"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: Obsidian MCP Server

MCP クライアントからのアイデアを今日の日報に取り込みます

👤 チャットに住んでいる Obsidian ユーザー ⏱ ~5 min beginner

使うタイミング: あなたはクロードとの会話の途中で、アプリを切り替えることなく意見を保管庫に保存したいと考えています。

前提条件
  • ローカル REST API プラグインが有効になった Obsidian — コミュニティプラグイン→「ローカルREST API」をインストール→APIキーをコピー
  • OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL で構成された MCP クライアント — config ブロックを参照してください。 通常、ベース URL は http://127.0.0.1:27123 です。
フロー
  1. 毎日のメモが存在することを確認してください
    Daily/2026-04-17.md の下にメモをリストします。✓ コピーしました
    → ファイルパスが確認されたか、「見つかりません」
  2. キャプチャを追加する
    「- アイデア: キャッシュのバグに対して X を試してください」を Daily/2026-04-17.md に追加します。✓ コピーしました
    → 以前のエントリを上書きせずに追加が確認されました

結果: エージェントが追加できる実行中のジャーナルであり、決して壊すことはありません。

注意点
  • 追加するつもりで上書きモードを使用する — 常にデフォルトで毎日のメモに追加または先頭に追加します。 新しいドラフト用に上書き保存
組み合わせ: filesystem

1 週間分のメモをレビュー文書に変える

👤 毎週レビューを行うナレッジ ワーカー ⏱ ~20 min intermediate

使うタイミング: 週の分散したメモを金曜日に統合する必要があります。

前提条件
  • タグ付きまたは日付付きのメモ — #weekly または Daily/ フォルダーを使用します
フロー
  1. 今週のメモを検索する
    グローバル検索: 今週、Daily/ の下でメモが変更されました。✓ コピーしました
    → 5 ~ 7 個のファイル パスのリスト
  2. それぞれ読んでください
    毎日のメモを読み、テーマごとにまとめます。✓ コピーしました
    → 生の連結ではなくテーマ付きの箇条書き
  3. レビューを書く
    概要を Reviews/2026-W16.md に書き込みます。 フロントマターのステータスを追加: レビュー、タグ: [毎週]。✓ コピーしました
    → 適切なフロントマターを含む新しいファイル

結果: 手動でコピー&ペーストすることなく、生の資料から構築された週次レビューノート。

組み合わせ: github

ボールト全体の乱雑なタグを統合する

👤 有機的に成長し、#Work / #work / #WORK のバリアントが追加された Vault ⏱ ~30 min intermediate

使うタイミング: 重複または重複に近いため、タグ リストが長すぎます。

フロー
  1. 現在のタグをリストする
    obsidian_manage_tags を使用して、使用法に従って並べ替えられたすべてのタグをリストします。✓ コピーしました
    → タグの数により重複が明らかになる
  2. マッピングを提案する
    正規セットと古い→新しいマッピングを提案します。✓ コピーしました
    → 小さくてレビュー可能なテーブル
  3. 一括で申請する
    確認したら、マッピングを使用して Vault 全体でタグの名前を変更します。✓ コピーしました
    → ノートごとにまとめられたタグ操作

結果: 実際にナビゲートできるクリーンなタグ分類。

注意点
  • バックアップなしで数百のメモを一度に書き換える — まずボールトを git にコミットします。 差分を確認する
組み合わせ: git

Web クリッピングをリサーチ受信トレイにドロップし、自動タグ付けします

👤 研究者、アナリスト、バリカン習慣のある人なら誰でも ⏱ ~15 min beginner

使うタイミング: 受信トレイやフォルダーは処理できる速度を超えて蓄積されます。

前提条件
  • 指定された受信トレイ/フォルダー — ボールト内に作成します
フロー
  1. 受信トレイをリストする
    Inbox/ の下にタグなしのメモをリストします。✓ コピーしました
    → 保留中のアイテムのパス
  2. 分類してタグ付けする
    それぞれについて、コンテンツに基づいて 1 ~ 3 つのタグを提案し、obsidian_manage_tags を適用します。✓ コピーしました
    → フロントマター経由でタグがアトミックに追加される

結果: 受信トレイは小さいままです。 新しいクリップは自動的に整理されます。

組み合わせ: fetch

組み合わせ

他のMCPと組み合わせて10倍の力を

obsidian-mcp-server + fetch

fetch で URL をクリップし、Inbox/ に書き込みます。

https://... を取得し、適切なフロントマターを付けて、整理された概要を Inbox/YYYY-MM-DD-title.md に保存します。✓ コピーしました
obsidian-mcp-server + github

マージされた PR サマリーを Projects/<repo>.md にコピーします。

今週マージされた PR を検索し、Projects/acme-api.md の ## Week 16 の下に概要を追加します。✓ コピーしました
obsidian-mcp-server + git

ボールトをバージョン管理し、バッチ変更をコミットする

タグのクリーンアップ後、コンテナーで git diff を実行し、コミットする前に要約します。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
obsidian_read_note path: str 特定のメモを編集または要約する前に読んでください。 0
obsidian_update_note path: str, content: str, mode: 'append'|'prepend'|'overwrite' メモの内容を追加または置換します - 書き換えない限り、デフォルトで追加されます 0
obsidian_search_replace path: str, find: str, replace: str ファイル全体を再生成せずに、対象を絞ったノート内編集が可能 0
obsidian_global_search query: str, filters? 保管庫全体でメモを検索する 0
obsidian_list_notes folder?: str バッチ操作の前にフォルダー内のメモを列挙する 0
obsidian_manage_frontmatter path: str, op: 'get'|'set'|'delete', key?: str, value?: any アトミックなキーレベルのフロントマターの変更 0
obsidian_manage_tags path?: str, op: 'list'|'add'|'remove' タグの衛生管理と分類操作 0
obsidian_delete_note path: str メモを削除します - 永続的で元に戻すことはできません 0

コストと制限

運用コスト

APIクォータ
外部 API なし - ローカル REST API は Mac/PC 上で実行されます
呼び出しあたりのトークン
ノートサイズ。 通常 200 ~ 3000
金額
無料
ヒント
フォルダー全体をコンテキストに一括リストするのではなく、global_search + オンデマンド読み取りを優先します。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: 環境変数の OBSIDIAN_API_KEY のみ - 決してコミットされません。 これをコンテナーに対するローカル管理者トークンのように扱います。
データ送信先: すべてのトラフィックは localhost → Obsidian Local REST API です。 このサーバーからのクラウド呼び出しはありません。

トラブルシューティング

よくあるエラーと対処法

エコノミスト 127.0.0.1:27123

Obsidian が実行されていないか、ローカル REST API プラグインが無効になっています。 Obsidian を開き、プラグインを有効にします。

確認: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/
401 不正

OBSIDIAN_API_KEY がプラグインの現在のキーと一致しません。 プラグイン設定から値を再度コピーします。

確認: Plugin Settings → Local REST API → copy the API key
既知のファイルの 404

パスは Vault に相対し、大文字と小文字が区別されます。obsidian_list_notes で確認してください。

確認: obsidian_list_notes folder='Daily'

代替案

Obsidian MCP Server 他との比較

代替案代わりに使う場面トレードオフ
obsidian-plugin-skillクロードには、Vault コンテンツの編集ではなく、Obsidian プラグインの作成を手伝ってもらいたいと考えています異なる範囲
filesystem MCP生のファイル操作には問題なく、Obsidian 対応のフロントマッター/タグ API は必要ありません。アトミックなタグ/フロントマター操作が失われる

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る