OH Blog

2026-0520 Obsidian × Claude Code 連携セットアップマニュアル

テック

2026-0520 Obsidian × Claude Code 連携セットアップマニュアル

Obsidian × Claude Code 連携セットアップマニュアル

Claude Code から Obsidian Vault を「外部脳」として読み書きできるようにする環境構築の記録。

0. ゴール

  • どのプロジェクトで Claude Code を起動しても、Obsidian Vault /Users/tom/GitHub/_obsidian を読み書きできる
  • 既存のノート構造は触らず、claude-code/ 配下を Claude Code 専用の引き出しとして使う
  • セッションを跨いだ知識の蓄積を Obsidian 側に持たせる

1. 全体構成

┌─────────────────────────────────────────────────────────┐

│ Claude Code (どのプロジェクトでも) │

│ ↓ MCP プロトコルで呼び出し │

│ obsidian-mcp-server (npx で起動するNode.jsプログラム) │

│ ↓ HTTP通信 (port 27123) │

│ Obsidian Local REST API プラグイン │

│ ↓ │

│ Vault: /Users/tom/GitHub/_obsidian │

│ └── claude-code/ ← ここだけ読み書きする │

│ ├── Knowledge/ │

│ ├── Decisions/ │

│ ├── Projects/ │

│ └── Preferences/ │

└─────────────────────────────────────────────────────────┘

2. 前提条件

  • macOS
  • Obsidian インストール済み
  • Vault パス: /Users/tom/GitHub/_obsidian
  • Claude Code (CLI) インストール済み
  • Node.js v18 以上(今回は v22.15.1)
  • Claude のサブスクリプション契約(Pro または Max)

3. セットアップ手順

STEP 1: Obsidian に Local REST API プラグインを入れる

  • Obsidian 起動 → 左下の歯車(設定)
  • 「コミュニティプラグイン」→「閲覧」
  • 検索: Local REST API(作者: Adam Coddington)
  • インストール → 有効化

STEP 2: API Key を取得

  • 設定画面 → 左メニュー下の「Local REST API」(プラグイン設定)
  • 上部に表示される API Key(64文字程度の英数字)をコピー
  • 手元のメモ帳などに保管(チャットや GitHub には貼らないこと)
  • HTTP (port 27123) と HTTPS (port 27124) の片方または両方をON
  • 今回は両方ONだが、実際に使うのは HTTP の 27123

STEP 3: 動作確認(curlで疎通テスト)

ターミナルで実行:

curl -H "Authorization: Bearer YOUR_API_KEY" http://127.0.0.1:27123/vault/

Vault 内のファイル一覧が JSON で返ってくれば成功。

よくあるエラー:

  • Connection refused → Obsidian未起動 or プラグイン無効
  • 401 Unauthorized → API Key 違い

STEP 4: Node.js 確認

node -v

v18.0.0 以上であれば OK。今回は v22.15.1。

STEP 5: Claude Code に MCP サーバーを登録(ユーザースコープ)

YOUR_API_KEY を実際のキーに置き換えて実行:

claude mcp add --scope user obsidian \

-e OBSIDIAN_API_KEY=YOUR_API_KEY \

-e OBSIDIAN_BASE_URL=http://127.0.0.1:27123 \

-- npx -y obsidian-mcp-server

成功時の出力:

Added stdio MCP server obsidian with command: npx -y obsidian-mcp-server to user config

File modified: /Users/tom/.claude.json

--scope user を指定しているので、全プロジェクトで 有効になる。

STEP 6: Claude Code 側で接続確認

cd /Users/tom/GitHub/office-hirose/oh-demo/oh-demo-lab

claude

起動後、チャット画面で:

/mcp

obsidian が connected(緑チェック)になっていれば成功。

STEP 7: 試運転(読み取り)

Claude Code に話しかける:

私のObsidian Vaultの中にあるファイルを一覧で教えて

初回はツール使用の許可ダイアログが出るので 許可。

STEP 8: フォルダ構造を作成(書き込みテスト)

Claude Code に依頼して以下を作成:

claude-code/

├── Knowledge/

│ ├── .gitkeep

│ └── mistakes.md (YAMLフロントマターのみ)

├── Decisions/

│ └── .gitkeep

├── Projects/

│ └── .gitkeep

└── Preferences/

└── .gitkeep

既存のフォルダ(@DDD/, Apple Notes/, Claude/ 等)とは別系統として

claude-code/ 配下に隔離するのがポイント。やめたくなったらこのフォルダごと削除すれば元通り。

STEP 9: グローバル CLAUDE.md を作成

新規作成: /Users/tom/.claude/CLAUDE.md

これは Claude Code のユーザーグローバル設定。

全プロジェクトで Claude Code 起動時に自動で読み込まれる。

プロジェクト固有の CLAUDE.md / AGENTS.md とは併用される。

内容は「Obsidian Vault を外部脳として扱うための運用ルール」(後述の§5参照)。

4. ファイルの配置場所まとめ

| 役割 | パス |

|------|------|

| MCP 登録ファイル | /Users/tom/.claude.json |

| グローバル指示 | /Users/tom/.claude/CLAUDE.md |

| Vault ルート | /Users/tom/GitHub/_obsidian/ |

| Claude Code 専用領域 | /Users/tom/GitHub/_obsidian/claude-code/ |

| AI ミス記録 | /Users/tom/GitHub/_obsidian/claude-code/Knowledge/mistakes.md |

5. 運用ルール(~/.claude/CLAUDE.md の要点)

読み取り(セッション開始時)

  • claude-code/Knowledge/mistakes.md と claude-code/Preferences/ を最初に読む
  • 質問キーワードで Vault を検索
  • 関係ない単発質問(「今何時?」等)はスキップ可

書き込み(その場で都度)

  • Knowledge/: バグ解決・ライブラリ発見・環境構築でハマったこと
  • Decisions/: 選択の判断記録(A vs B、なぜA)
  • Projects/: プロジェクトの状態変化
  • Preferences/: 広瀬の好み・作業スタイル

書き込みフォーマット

---

date: YYYY-MM-DD

tags: [...]

project: project-name

related: [[Other Note]]

---

  

# タイトル

本文。関連ノートは [[wiki link]] でリンク。

命名規則

| フォルダ | 形式 | 例 |

|---------|------|-----|

| Knowledge | topic-subtopic.md | nextjs-auth-cookie.md |

| Decisions | YYYY-MM-DD-topic.md | 2026-05-20-database-choice.md |

| Preferences | category.md | coding-style.md |

| Projects | project-name.md | oh-demo-lab.md |

mistakes.md への追記条件(3つ全て満たすとき)

  • ユーザーからの明示的な訂正
  • 繰り返し起こり得るパターン
  • 「する/しない」で書ける

透明性

  • 読み書きしたら必ず報告
  • サイレント操作禁止

広瀬固有

  • 漢字は「広瀬」(廣瀬ではない)
  • 回答は STEP BY STEP、一度に多くを答えない、質問も1つずつ
  • カレンダー確認は ①info@office-hirose.com ②xxx@xxx.com の両方

6. トラブルシューティング

MCP が failed / error になる

  • Obsidian が起動しているか
  • Local REST API プラグインが有効か
  • API Key が /Users/tom/.claude.json に正しく入っているか
  • ポート 27123 で受け付けているか(curl で確認)

Claude Code が Vault を読まない

  • グローバル ~/.claude/CLAUDE.md が存在するか
  • Claude Code を一度再起動

既存ノートを誤って触られそうで怖い

  • ~/.claude/CLAUDE.md の「Vault 情報」セクションで claude-code/ 配下以外には触れないと明示済み
  • 不安なら Vault を Git 管理にしてバージョン管理する

7. やめたいとき・元に戻したいとき

# MCP サーバーを削除

claude mcp remove obsidian --scope user

  

# グローバル CLAUDE.md を削除(または編集)

rm /Users/tom/.claude/CLAUDE.md

  

# Obsidian 側のプラグイン無効化

# 設定 → コミュニティプラグイン → Local REST API → 無効化

  

# Vault の claude-code/ フォルダごと削除

rm -rf /Users/tom/GitHub/_obsidian/claude-code/

8. 参考リンク

9. このマニュアル自体について

  • 作成日: 2026-05-20
  • 作成経緯: Anthropic の Claude (チャット版) と対話しながら STEP BY STEP でセットアップ
  • 場所: claude-code/Knowledge/obsidian-claude-code-setup.md
  • 次回、同じセットアップを別マシンで再現するときに、このファイルを最初に読めば再現可能

プラグインのインストール

MCP Serverで起動OK

一覧に戻る

All list

読み込み中…

Search

キーワードを入力してください。