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