obsidian-claude-integration

Obsidian セカンドブレイン + Claude Code の統合

概要

Obsidian と Claude Code を統合して、Obsidian の保管庫を AI を活用したセカンドブレインに変えましょう。 このスキルでは、最小限のセットアップから高度な自己進化システムまで、複数の統合パターンを紹介します。

重要なポイント：Obsidian の保管庫は、基本的に Markdown ファイルで構成されるコードベースです。Claude Code はすでにファイル構造の把握と細かな編集に優れているため、特別なプラグインは必要ありません。

統合パターン

判断フロー

What integration level do you need?
├── Minimal (just works)?
│   └── Pattern A: Direct Access
│       └── Claude Code reads vault directly (no setup needed)
├── Enhanced discovery?
│   └── Pattern B: Manifest-Based
│       └── Add CLAUDE.md to vault root
├── Real-time bidirectional?
│   └── Pattern C: MCP Plugin
│       └── Install obsidian-claude-code-mcp
├── Self-evolving PKM?
│   └── Pattern D: COG Pattern
│       └── Git + automation + self-healing refs
└── Pre-configured structure?
    └── Pattern E: Claudesidian
        └── Adopt opinionated vault structure

パターン A：直接アクセス（セットアップ不要）

Claude Code はすでに保管庫の読み取りと編集ができます。設定は不要です。

動作の仕組み

# Claude Code navigates your vault like any codebase
cd /path/to/your/vault
claude

# Example interactions:
# "Read my daily note from today"
# "Find all notes mentioning project X"
# "Add backlinks to people mentioned in this note"

ベストプラクティス

• 保管庫のルートディレクトリから Claude Code を起動します
• やりたいことを自然な言葉で説明します
• 正確なパスではなく、ファイル名やトピックを指定します

ユースケース

タスク	Claude Code の機能
ノートを読む	ファイルに直接アクセス
ノートを編集する	Markdown を細かく編集
バックリンクを追加する	参照を検索し、ウィキリンクを挿入
ノートを作成する	適切なフロントマターを付けて新しいファイルを作成
コンテンツを検索する	すべての Markdown ファイルを横断して grep
構造をリファクタリングする	ファイルを移動し、参照を更新

パターン B：マニフェストベース（CLAUDE.md）

プロジェクトマニフェストを追加し、Claude Code が保管庫の構造と規約を理解できるようにします。

CLAUDE.md テンプレート

保管庫のルートに CLAUDE.md を作成します。

# Obsidian Vault Manifest

## Vault Overview
This is a personal knowledge management vault using [describe your system].

## Folder Structure
- `00 - Inbox/` - Quick capture, unsorted notes
- `01 - Projects/` - Active project notes
- `02 - Areas/` - Ongoing responsibilities
- `03 - Resources/` - Reference materials
- `04 - Archive/` - Completed/inactive content
- `Daily/` - Daily notes (YYYY/MM/DD.md format)
- `Templates/` - Note templates

## Conventions
- Frontmatter: Always include `created`, `updated`, `tags`
- Links: Use `[[wikilinks]]` not markdown links
- Tags: Hierarchical (e.g., `#project/client-name`)
- Dates: ISO 8601 format (YYYY-MM-DD)

## Important Files
- `_index.md` - Main dashboard/MOC
- `project-context.md` - Current project context

## When Creating Notes
1. Always add proper frontmatter
2. Include backlinks to related notes
3. Tag appropriately for discoverability
4. Place in correct folder based on type

## When Editing Notes
1. Update the `updated` timestamp
2. Maintain existing link structure
3. Preserve block references (^block-id)

完全なテンプレートについては、templates/CLAUDE.md を参照してください。

パターン C：MCP プラグイン統合

Model Context Protocol を介したリアルタイムの双方向通信です。

インストール

# Install the MCP plugin from Obsidian Community Plugins
# Plugin: obsidian-claude-code-mcp
# Repository: github.com/iansinnott/obsidian-claude-code-mcp

設定

1. Obsidian でプラグインを有効にします
2. デフォルトの WebSocket ポート：22360
3. Claude Code は実行中の Obsidian インスタンスを自動検出します

MCP の機能

機能	説明
read_note	メタデータとともにノートの内容を読み取る
write_note	ノートを作成または更新する
search	保管庫全体をセマンティック検索する
list_notes	保管庫の構造を一覧表示する
get_backlinks	あるファイルにリンクしているノートを検索する
get_outlinks	あるファイルがリンクしているノートを検索する
get_tags	保管庫内のすべてのタグを一覧表示する

Claude Code の MCP 設定

自動検出されない場合は、Claude Code の設定に追加します。

{
  "mcpServers": {
    "obsidian": {
      "transport": "websocket",
      "url": "ws://localhost:22360"
    }
  }
}

パターン D：COG 自己進化パターン

自動整理機能を備えた、Git ベースの自己進化型セカンドブレインです。

アーキテクチャ

vault/
├── .git/                    # Version control
├── CLAUDE.md                # AI manifest
├── _meta/
│   ├── patterns.md          # Learned patterns
│   ├── conventions.md       # Auto-discovered rules
│   └── maintenance-log.md   # Self-healing log
├── notes/                   # Content
└── daily/                   # Journal

自己修復機能

1. 相互参照の自動更新：ノートの移動時にリンクを更新します
2. パターン学習：ユーザーの規約を見つけて適用します
3. 孤立ノートの検出：リンクされていないノートを特定します
4. 一貫性チェック：フロントマターとタグを検証します

Git フックのセットアップ

# .git/hooks/post-commit
#!/bin/bash
# Trigger Claude Code maintenance after commits

claude --print "Check for broken links and orphan notes in the vault.
Fix any issues and update _meta/maintenance-log.md with actions taken."

メンテナンスコマンド

# Ask Claude Code to perform maintenance
claude "Analyze my vault for orphan notes and suggest connections"
claude "Find notes without proper frontmatter and fix them"
claude "Update all daily notes with missing navigation links"

パターン E：Claudesidian の構造

AI とのやり取りに最適化された、事前設定済みの保管庫構造を採用します。

フォルダー構造

vault/
├── CLAUDE.md                # Manifest (required)
├── Inbox/                   # Quick capture
├── Projects/                # Active work
├── Knowledge/               # Permanent notes
├── Journal/                 # Daily reflection
├── Templates/               # Note templates
└── _meta/                   # System files
    ├── prompts/             # Saved prompts
    ├── contexts/            # Context files
    └── exports/             # Generated outputs

主な規約

• すべてのノートに id、created、updated を含むフロントマターを設定します
• タグは階層形式にします：#type/subtype
• デイリーノートから前日・翌日のノートにリンクします
• テンプレートに Claude Code 用のプロンプトを含めます

一般的なワークフロー

人物、場所、書籍の自動リンク

User: "Read my journal entry from today and add backlinks to all
people, places, and books mentioned"

Claude Code:
1. Reads today's daily note
2. Extracts entity mentions
3. Searches vault for existing notes
4. Creates new notes if needed
5. Inserts [[wikilinks]] throughout

ナレッジグラフのメンテナンス

User: "Find orphan notes and suggest connections"

Claude Code:
1. Identifies notes with no incoming/outgoing links
2. Analyzes content for potential connections
3. Suggests or creates links
4. Updates MOCs (Maps of Content)

調査内容の統合

User: "Synthesize all my notes on [topic] into a summary note"

Claude Code:
1. Searches for relevant notes
2. Extracts key insights
3. Creates structured summary
4. Links back to source notes

デイリーノートの拡充

User: "Review today's note and add structure"

Claude Code:
1. Reads raw capture
2. Adds proper frontmatter
3. Identifies tasks → adds checkboxes
4. Identifies mentions → adds links
5. Suggests tags based on content

ベストプラクティス

すべてのパターンに共通

1. 保管庫をバージョン管理下に置く - Git により、変更の追跡とロールバックができます
2. フロントマターを統一する - Claude Code がノートの種類を理解しやすくなります
3. マニフェストを維持する - CLAUDE.md によってコンテキストと規約を伝えられます
4. 定期的にメンテナンスする - Claude Code に定期的な問題の確認を依頼します

MCP 統合の場合

1. Obsidian を起動したままにする - MCP にはアクティブな接続が必要です
2. セマンティック検索を使用する - MCP の検索機能を活用します
3. 競合に対処する - 同時編集に注意します

自己進化するシステム向け

1. AI による変更を確認する - コミット前に git diff を確認します
2. 好みを学習させる - 間違いを修正してパターンを改善します
3. 例外を記録する - エッジケースをマニフェストに追加します

トラブルシューティング

Claude Code がノートを見つけられない

# Ensure you're in the vault directory
pwd  # Should show vault path

# Check file permissions
ls -la *.md

# Verify markdown extension
find . -name "*.md" | head -20

MCP 接続に失敗する

# Check Obsidian is running
pgrep -l Obsidian

# Verify plugin is enabled
# Settings → Community Plugins → obsidian-claude-code-mcp

# Check port availability
lsof -i :22360

# Test WebSocket connection
websocat ws://localhost:22360

編集後に Wikilink が壊れる

# Ask Claude Code to fix
claude "Find all broken wikilinks in the vault and fix them"

# Or use grep to find issues
grep -r "\[\[" --include="*.md" | grep -v "\.obsidian"

統合方法の比較

機能	直接	マニフェスト	MCP	COG	Claudesidian
必要なセットアップ	なし	最小限	プラグイン	Git + フック	構成
リアルタイム同期	いいえ	いいえ	はい	いいえ	いいえ
セマンティック検索	基本	基本	はい	基本	基本
自己修復	いいえ	いいえ	いいえ	はい	部分的
ベンダーロックイン	なし	なし	低い	なし	構成
最適な用途	シンプルさ	整理	パワーユーザー	自動化	新しい Vault

リソース

リファレンス

• references/mcp-integration.md - MCP プロトコルの詳細
• references/cog-pattern.md - 自己進化アーキテクチャ
• references/workflows.md - 一般的な自動化ワークフロー

テンプレート

• templates/CLAUDE.md - Vault マニフェストのテンプレート
• templates/daily-note.md - AI に適したデイリーノート
• templates/project-note.md - プロジェクトノートのテンプレート

外部リソース

• obsidian-claude-code-mcp - MCP プラグイン
• COG-second-brain - 自己進化パターン
• Claudesidian - 事前構成済み Vault
• minimal-second-brain - 最小限のテンプレート

クイックスタート

最速の方法（パターン A + B）

# 1. Navigate to your vault
cd /path/to/your/obsidian/vault

# 2. Create a minimal manifest
cat > CLAUDE.md << 'EOF'
# Vault Manifest

This is my Obsidian vault. Key conventions:
- Daily notes in `Daily/YYYY/MM/DD.md`
- Use `[[wikilinks]]` for internal links
- Frontmatter with `created`, `updated`, `tags`
EOF

# 3. Start using Claude Code
claude "What notes do I have about [topic]?"

完全な統合（パターン C）

1. obsidian-claude-code-mcp プラグインをインストールします
2. CLAUDE.md マニフェストを作成します
3. Obsidian の設定でプラグインを有効にします
4. Claude Code が WebSocket 経由で自動接続します

自己進化型のセットアップ（パターン D）

1. Vault で git を初期化します
2. CLAUDE.md マニフェストを作成します
3. メンテナンス用の git フックを追加します
4. Claude Code による定期的なレビューをスケジュールします

---

注意点

• Vault のパスにスペースが含まれていると、引用符なしの raw bash heredoc で問題が発生します — パスを組み立てる際は、常に "$VAULT"（引用符付き）を使用してください。スペースがあると、パスの引数が気付かないうちに 2 つに分割されます。
• MCP サーバーのライフサイクル：クラッシュしたサーバーは、再試行まで約 30 秒間、遷移状態のままになります — この間、claude はエラーを表示せず、ただ待機します。
• Claude による frontmatter への追記では、キーが気付かないうちに重複する場合があります — YAML ではキーの重複が許可されます。Obsidian は最後のキーを表示しますが、一部のプラグインは最初のキーを読み取ります。無条件に追記するのではなく、必ずパーサーを使ってその場で編集してください。
• Vault のルート直下に置いた CLAUDE.md マニフェストと .obsidian/ 配下に置いたもの — Vault ルートにあるものは人から見えます。.obsidian/ にあるものはフォルダーの再編成後も残りますが、非表示になります。
• MCP のファイルシステムツールは Vault のサンドボックスに従いますが、生の Bash は従いません — シェルコマンドから意図せず範囲外に出やすいため、各スキルで境界を明示的に記載してください。