Obsidian MCP Tools — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

ローカルObsidianプラグイン + MCPブリッジ
Smart Connections統合によるセマンティック検索
ClaudeからのTemplaterプロンプト実行
完全なファイルCRUD：読み取り・書き込み・追記・リンク・frontmatter
デイリーノート + ジャーナル対応
Vaultデータがマシンの外に出ない

ライブデモ

実際の動作

obsidian-mcp-tools.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

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

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

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

ユースケース

実用的な使い方： Obsidian MCP Tools

グレップの代わりにセカンドブレインに実際にクエリする方法

👤 1000件以上のノートを持つObsidian PKMユーザー ⏱ ~20 min intermediate

使うタイミング： 数ヶ月前に何かについて書いたことは知っているが、キーワード検索では見つからない場合。

前提条件

Obsidian + このプラグイン + Smart Connectionsプラグイン — コミュニティプラグインから両方をインストール；Smart Connectionsは初回実行時にインデックスを作成します

フロー

インデックス確認

Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ コピーしました

→ インデックス済みノート数；使用中のembeddingモデル
セマンティック想起

Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ コピーしました

→ セマンティックマッチでランク付けされた5件のノートとスニペット
まとめる

Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ コピーしました

→ 新しいノートが作成され；バックリンクが解決される

結果： キーワードではなくコンセプトで答えるセカンドブレイン。

注意点

セマンティック想起がデリケートな個人ノートを表示する — ObsidianのSmart ConnectionsのexcludedFolders設定でプライベートディレクトリをスキップしてください

組み合わせ： humanizer-skill

プロンプトを自動入力してClaudeからTemplaterテンプレートを実行する

👤 テンプレートを持つObsidianパワーユーザー ⏱ ~10 min intermediate

使うタイミング： 5つのプロンプトを尋ねる「プロジェクトキックオフ」Templaterテンプレートがあり、Claudeにオーケストレーションさせたい場合。

前提条件

テンプレートをセットアップ済みのTemplater — 標準コミュニティプラグイン

フロー

テンプレートを一覧する

What Templater templates are available?✓ コピーしました

→ プロンプトの説明付きテンプレートリスト
自動入力で実行する

Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ コピーしました

→ テンプレートを使って新しいノートが作成；プロンプトが入力される

結果： モーダルダイアログではなくチャットからテンプレートを実行。

注意点

一部のTemplaterコマンドは非同期で時間がかかる — MCPツールは完了を待ちます — ただし1回の呼び出しに多くを連鎖させないでください

昨日のカレンダーとタスクからデイリーノートを自動構築する

👤 生産性重視のObsidianユーザー ⏱ ~15 min intermediate

使うタイミング： 毎日同じ「Daily」テンプレートを編集している — 自動化しましょう。

フロー

今日のデータを取得する

Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ コピーしました

→ 繰り越されたタスク + 今日のイベントが特定される
デイリーを書き込む

Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ コピーしました

→ ノートが作成されて開かれる

結果： 5秒でデイリーノートが準備完了。

注意点

同じタスクが2日分にある場合、繰り越しで重複する — 書き込む前に行テキストで重複除去してください

組み合わせ： google-calendar

組み合わせ

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

obsidian-mcp-tools + google-calendar

その日のイベントを含むデイリーノートを構築する

Make today's daily note. Include calendar events under '## Today'.✓ コピーしました

obsidian-mcp-tools + github

プロジェクトボードをvaultノートにミラーする

Sync GitHub project XYZ tasks to /Projects/XYZ.md as a checklist.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
search_semantic	query, k?	コンセプトレベルの想起	1 Smart Connections query
read_note	path	単一ノートを取得する	free
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	ノートを作成または更新する	free
list_templates	(none)	実行可能なものを確認する	free
run_templater	template_name, prompt_answers: {}	テンプレート化されたワークフローを実行する	free

コストと制限

運用コスト

APIクォータ: ローカル — クラウドベースの場合はSmart Connectionsのembeddingサービスに依存
呼び出しあたりのトークン: ノートあたり100〜1500
金額: 無料（プラグイン）；Smart Connectionsは無料ローカル + 有料クラウドオプションあり
ヒント: Smart Connectionsでローカルembeddingオプションを使用してクエリごとのコストを避けてください

セキュリティ

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

認証情報の保管： ローカルプラグインのみ；リモートストレージなし

データ送信先： ローカル — Smart Connectionsがクラウドembeddingを使用するよう設定されている場合を除く

promptを信頼しない限りClaudeにvaultの書き込みアクセスを付与しないでください；デリケートな領域には除外フォルダーを使用してください

トラブルシューティング

よくあるエラーと対処法

MCPツールが表示されない

Obsidianプラグインが有効でMCPブリッジプロセスが実行中であることを確認してください

確認： プラグインのステータスバーを確認；Obsidianを再起動

search_semanticが何も返さない

Smart Connectionsのembeddingジョブがまだ完了していない可能性があります — 進捗を確認してください

確認： Smart Connectionsサイドバーを開く

write_noteが「vault外のパス」で失敗する

パスはvaultルートからの相対パスです；絶対パスを使用しないでください

代替案

Obsidian MCP Tools 他との比較

代替案	代わりに使う場面	トレードオフ
ergut/mcp-logseq	ObsidianではなくLogseqを使用している場合	異なるエコシステム；同じ考え方
AgriciDaniel/claude-obsidian (skill)	ファイルIOの上にスキル形式のワークフローが欲しい場合	スキルはより高レベル；このMCPはビルディングブロック

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

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