ObsidianのVault（Markdownの保管フォルダ）をClaude Codeにつなぐと、蓄積したメモをそのままAIエージェントの文脈として読ませ、実装計画やタスク整理を自然言語で回せます。Claude CodeとObsidianの連携の入口は2026年9月時点で5通りあり、準備の重さも「ターミナルでclaudeを叩くだけ」から「専用プラグインを入れる」まで幅がある構成です。この記事では、Vault直結・Local REST API内蔵のMCPサーバー接続・公式Obsidian CLI・Claudianプラグイン・Claude Desktopコネクターの各方式を、コピーして動かせる設定例つきで比較します。obsidian claude code mcpの構成やタスク管理での使い方、企業のナレッジ基盤として採用してよい条件までを技術者向けに整理しました。
まとめ：Claude CodeとObsidian連携の5方式と選び方の要点
ObsidianとClaude Codeの連携は、Vaultフォルダを直接AIの作業ディレクトリにする方式が最も軽く、無料で最速で試すならClaude Desktopのフォルダコネクター、Obsidianの画面内で完結させたいならClaudianプラグイン、既存のCLI運用へ組み込むならMCPサーバー接続、という住み分けになります。2026年に入ってからはObsidian公式のCLIが加わり、Vault直結のまま検索やデイリーノート追記をObsidian本体に任せる中間の選択肢もできました。
選定の軸は3つ。編集をObsidianのUI内で見たいか、準備にプラグインを何本許容できるか、Vault全体をAPIで開いてよいか。個人のメモ整理なら最軽量のVault直結で十分です。一方、機密ノートが混在する組織の共有Vaultでは、Local REST APIでVault全文を露出する構成は避け、対象フォルダを分離するか閉じたネットワークに限定します。なお、以前よく紹介されていた「MCP Tools for Obsidian」は2026年5月にアーカイブ済みで、MCP接続はLocal REST API本体の内蔵サーバーへ移すのが現行の組み方です。以降で各方式の手順と、採用・見送りの分岐点を具体的に示します。
ObsidianとClaude Codeを連携する仕組みと前提条件
連携の技術的な核心は単純です。ObsidianのVaultは、拡張子.mdのプレーンテキスト（Markdown）が並ぶただのフォルダにすぎません。Claude Codeはターミナルで動くAIコーディングエージェントで、指定した作業ディレクトリのファイルを読み・検索し・書き換える権限を持ちます。この2つが重なる地点が連携の実体です。
Vaultは特殊形式ではなくMarkdownフォルダという前提
ObsidianがデータベースやクラウドではなくローカルのMarkdown群でノートを持つ設計だからこそ、外部のエージェントからファイルとして触れます。画像やPDFを添えても、本文はテキストのまま。ここがNotionのようなAPI前提のツールとの決定的な差です。連携の下ごしらえは「どのフォルダがVaultか」を把握するだけで済みます。Obsidian側の内部リンクやタグはMarkdownの記法として残るため、AIにも構造のまま伝わる形です。Vaultの隠しフォルダ.obsidianにはテーマやプラグイン設定が入るので、AIの編集対象から外しておくと安全です。Obsidian側の設定構造はObsidianのテーマや外観設定などのカスタマイズ解説で確認できます。
連携の前提となるClaude Code本体の導入方法と料金体系
連携のもう一方の前提はClaude Code側です。2026年9月時点のClaude Code公式のセットアップ手順では、ネイティブインストーラが推奨になっています。npm経由でも入りますが、その場合はNode.js 22以上が要件です。利用にはPro／Max／Team／Enterpriseのいずれかのプラン、またはConsoleアカウント（API従量）が必要で、無料プランには含まれません。ブラウザ版のClaude.aiやチャットUIだけではローカルファイルを操作できない点も押さえておきます。
# macOS・Linux・WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# 導入確認（バージョン番号が表示されればOK）
claude --version
料金の考え方や基本操作はClaude Code自体のできることと料金体系の解説、権限やCLAUDE.mdの初期設定はClaude Codeの導入から権限とCLAUDE.md設定までの手順に譲り、本記事はObsidianとつなぐ部分に絞ります。前提を外すと以降の手順が噛み合わないため、まずCLIが単体で起動する状態を作ってから連携に進みます。
プラグイン不要のフォルダ直結とMCP経由という2系統の考え方
連携方式は大きく2系統に割れます。ひとつはClaude CodeにVaultフォルダをそのまま作業対象として渡す直結型。もうひとつはObsidianを常駐サーバー化し、Model Context Protocol（MCP）というAIとツールの標準接続規格を介してつなぐMCP型です。直結型は準備が軽い代わりにObsidianアプリを介さずファイルを直接触ります。MCP型はObsidian起動中のプラグインAPIを経由するため、Obsidianの検索や既存ノートの整合を保ったまま操作できる点が持ち味です。その中間に位置するのが公式Obsidian CLIで、直結型のClaude CodeからBashツール経由でObsidian本体のコマンドを呼び出せます。MCPという規格自体の仕組みはMCP（Model Context Protocol）の標準規格としての仕組みで押さえておくと、以降の設定が読みやすくなります。
連携5方式の比較｜フォルダ直結・MCP・公式CLI・プラグイン・Desktop
2026年9月時点で実用になる連携方式は5つです。準備の重さ、Obsidianの画面内で編集を見られるか、想定用途で整理すると選びやすくなります。まず全体像を表で押さえ、続く章で手順に入ります。
連携5方式を準備の重さとObsidian統合の深さで並べた早見表
下表は上ほど軽く、下ほどObsidian統合が深い並びです。実務ではまず一番上のVault直結を試し、検索の精度が欲しくなったら公式CLIかMCP、画面内で完結させたい要求が出た段階でClaudianへ移ると無駄がありません。
| 方式 | 準備 | 編集の見え方 | 向く用途 |
|---|---|---|---|
| Vault直結 | CLIのみ | ターミナル側 | 個人・最速検証 |
| 公式Obsidian CLI | 設定の有効化 | アプリに即時反映 | 検索と追記の自動化 |
| MCPサーバー接続 | プラグイン1種 | 一部Obsidian内 | 検索と参照重視 |
| Claudianプラグイン | プラグイン1種 | Obsidian内で完結 | UI統合したい人 |
| Claude Desktop連携 | 設定3クリック | Desktop側 | 無料で試す層 |
MCPサーバー接続は、以前は「Local REST API」と「MCP Tools for Obsidian」の2枚が必要でしたが、現在はLocal REST API単体で内蔵MCPサーバーを持つため準備が1枚減りました。Obsidianの検索インデックスやアクティブなノートを使った参照に強みがあります。Claudianはプラグイン1本でチャットから編集まで内蔵する構成です。
obsidian claude code mcpで語られる構成の位置づけ
検索で見かける「obsidian claude code mcp」は、上表のMCPサーバー接続を指します。ObsidianをMCPサーバーとして公開し、Claude Codeがクライアントとして接続する形です。解説記事の多くはjacksteamdev氏のMCP Tools for Obsidianを前提にしていますが、同リポジトリは2026年5月13日にアーカイブされ、保守が止まっています。現行の組み方は、Local REST APIプラグインに内蔵された/mcp/エンドポイント（Streamable HTTP方式）へ直接つなぐものです。npmで配布される別実装のobsidian-mcpも存在しますが、Obsidianアプリを介さずファイルを読むため、性質はVault直結に近いと捉えておくと整理しやすくなります。
Claude Codeを使わないClaude Desktop方式との違い
混同しやすいのがClaude Desktop方式です。こちらはCLIのClaude Codeではなく、デスクトップアプリのClaude Desktopが持つコネクター機能でVaultフォルダを読み書きします。設定は数クリックで無料プランでも試せる反面、Claude Code特有のBashツールやスラッシュコマンドは使えません。「まず触ってみたい」段階の入口としては最軽量ですが、エージェント的に自律実行させたい開発用途ではClaude Code側の方式へ進むことになります。Desktop側のコネクター設定やMCPの追加手順はClaude Desktopのできることとインストール・MCP連携の手順にまとめています。
Vault直結・内蔵MCP・公式CLIの3経路をセットアップする手順
ここからは実装です。最軽量のVault直結、参照に強いMCPサーバー接続、その中間にあたる公式Obsidian CLIの3つを手順で示します。コマンドはmacOSを例にしますが、WindowsやLinuxでも考え方は同じです。
Vault直結：CLAUDE.mdを置いてVaultで起動する最短の手順
プラグインを一切入れない最短経路です。やることは実質1つ、VaultのフォルダでClaude Codeを起動するだけです。
- ターミナルでVaultのフォルダへ移動する（Obsidianの設定でVaultの保存場所を確認）
- Vaultのルートに規約ファイルCLAUDE.mdを置き、命名規則や編集禁止事項を書いておく
- その場所で
claudeを実行し、Claude Codeを起動する
Claude Codeのメモリ機能の公式docsによると、CLAUDE.mdは作業ディレクトリ直下か.claude/CLAUDE.mdに置けば起動時に読み込まれ、1ファイル200行以内が推奨です。Vault向けには次のような短い規約で足ります。
# Vault運用ルール（Claude Code向け）
- ノートの削除・改名は、必ず確認を取ってから行う
- 日付は西暦（YYYY-MM-DD）で書く
- 新規ノートは 00_Inbox/ に作る。他フォルダへの作成は指示があるときだけ
- .obsidian/ と 90_Private/ は開かない・編集しない
- ノート間のリンクは [[ノート名]] 形式で書く
注意したいのは、CLAUDE.mdはあくまでAIへの指示であって強制力のある設定ではない点です。機密フォルダを確実に読ませたくないなら、Vault内の.claude/settings.jsonにClaude Codeの権限設定で拒否ルールを書きます。
{
"permissions": {
"deny": [
"Read(./90_Private/**)",
"Edit(./90_Private/**)",
"Edit(./.obsidian/**)"
]
}
}
公式docsではGrepやGlobへのRead拒否の適用は「ベストエフォート」とされているため、本当に見せてはいけないノートはVaultの外へ出すのが確実です。これでClaude CodeはVault内の許可範囲のMarkdownを読み・検索し・追記できます。難点は、編集がObsidianの画面ではなくターミナル側で進む点。Obsidianを開き直すとファイルが更新されている、という体験になります。個人のメモ整理やタスク棚卸しなら、この軽さで十分に回ります。
MCP接続：Local REST API内蔵のMCPサーバーへ登録する手順
Obsidianの検索や既存プラグインと整合させたい場合はMCP接続を選びます。2026年9月時点の手順はプラグイン1枚で完結します。
- Obsidianのコミュニティプラグインで「Local REST API」を導入・有効化し、生成されたAPIキーを控える
- プラグインが生成したローカル認証局（CA）の証明書を、OSまたはクライアント側で信頼させる
- Claude Code側に
claude mcp addでHTTP方式のサーバーとして登録する claude mcp listで接続を確認し、セッション内でツールが見えるか点検する
Local REST APIのREADMEに記載された登録例は次のとおりです。<your-api-key>は手順1で控えたキーに置き換えます。
# Obsidian（起動中）の内蔵MCPサーバーをClaude Codeへ登録する
claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ \
--header "Authorization: Bearer <your-api-key>"
# 接続状態の確認と、登録内容の詳細表示
claude mcp list
claude mcp get obsidian
Claude CodeのMCP公式docsでは、既定のlocalスコープとuserスコープは~/.claude.json、projectスコープはリポジトリ直下の.mcp.jsonに保存されると説明されています。APIキーはVaultの全ノートを読み書きできる鍵なので、Git管理される.mcp.jsonへ直書きせず、localスコープで登録するのが無難です。詰まりやすいのは証明書で、Local REST APIは自己署名のCAでHTTPS（ポート27124）を提供します。READMEでは、https://127.0.0.1:27124/obsidian-local-rest-api.crtから証明書を取得して信頼させるか、設定でHTTPエンドポイント（ポート27123）を有効にしてhttp://127.0.0.1:27123/mcp/へつなぐ方法が案内されています。後者は暗号化されないので、用途は同じマシン内での検証に限定すべきです。接続後は「今開いているノートの見出しを一覧にして」と頼み、Vaultの内容が返れば疎通確認は完了です。
公式Obsidian CLI：Claude Codeでのobsidianコマンド実行手順
Obsidianは2026年2月の1.12系で公式CLIを追加しました。Obsidian公式ヘルプのCLIページによると、設定の「一般」から「Command line interface」を有効にするとobsidianコマンドが使えるようになり、要件は1.12.7以上です。CLIは起動中のObsidianアプリを操作するリモコンとして動き、アプリが閉じていれば最初のコマンドで立ち上がります。Vault直結のClaude Codeに次のコマンドを実行させると、Obsidian本体の検索やテンプレートを通した操作になります。
# Vault内を全文検索する
obsidian search query="認証 リファクタリング"
# テンプレートを指定してノートを作る
obsidian create name="2026-09-29 設計メモ" template=Meeting
# 今日のデイリーノートへタスクを追記する
obsidian daily:append content="- [ ] 認証まわりのテストを追加"
さらに、ObsidianのCEOであるkepano氏がobsidian-skillsを公開しています。Obsidian独自のMarkdown記法・Bases・JSON Canvas・Obsidian CLIの扱い方をエージェント向けスキルとしてまとめたもので、Vaultの.claudeフォルダへ配置するとClaude Codeが必要に応じて読み込む仕組みです。スキルの仕組みそのものはClaude SkillsとSKILL.mdの書き方で解説しています。CLIとスキルの組み合わせは、MCPのAPIキー管理を避けつつObsidianの機能を使いたい場合の現実的な落としどころです。
Claudian：Obsidian内で完結させるプラグイン導入
ターミナルとの往復を避けたいなら、YishenTu氏のClaudianを使います。MITライセンスのOSSで、GitHubのスターは2026年9月時点で1.5万を超えました。導入はObsidianのプラグインとしてClaudianを入れ、前提としてClaude Code CLIなどのエージェントCLIをあらかじめ導入しておくだけです。ClaudianはVaultを作業ディレクトリとして扱い、チャットUI・選択範囲のインライン編集・@mention参照・スラッシュコマンド・MCP連携をObsidianの画面内で提供します。現在はClaude CodeのほかCodex CLIやOpenCodeなど複数のエージェントCLIを切り替えられる構成で、要件はObsidian 1.13.0以上です。デスクトップ限定で、Obsidian Mobileでは動きません。
知識ベースとAIエージェントを連結する開発ワークフローの構築
連携の価値は、つなぐこと自体ではなく、蓄積した知識を実装作業へ流し込める点にあります。散らばったメモをAIの文脈に載せると、過去の判断を数十秒で引き当て、次の実装計画へと変換できるのが利点です。ここでは実務で機能する使い方を、タスク管理と知識蓄積の2軸で示します。
KanbanプラグインとClaude Codeで組むタスク管理の運用
ObsidianのKanbanプラグインでボードを作り、Claude Codeにカードの出し入れを任せる運用が広がっています。daily・inbox・reading・writingのようにボードを役割で分け、規約ファイルに「完了時は西暦の日付を添える」「列名は変更しない」「新規カードは先頭列の末尾へ足す」と明文化しておくと、AIの更新が一貫します。obsidian claude code タスク管理という検索が示すのは、この「AIにボードを維持させる」需要です。人はカードを眺めて優先順位を決め、機械的な移動と記録はAIに寄せる、という分担が現実的でしょう。公式CLIを有効にしているなら、日々のタスク追記はobsidian daily:appendに任せるとファイル名の揺れが起きません。
Vaultの過去メモを実装計画へ変換する知識蓄積と検索の設計
もうひとつの型は、実装ログをVaultに貯め続け、次の課題で引くことです。バグ対応の際に「以前この認証まわりで詰まった記録は？」と尋ねれば、関連ノートを横断して該当箇所を返します。新機能の設計時には、アイデアメモから設計方針・振り返りまでを1本の流れとして残せます。ポイントは、AIが後から検索しやすいよう、ノートに固有名詞と日付を残しておくこと。フォルダを01_Projects・02_Ideas・03_Learningsのように意味で分けると、AIへの指示も「03_Learningsから該当例を探して」と具体化できます。Cursorを使った近い運用はCursorとObsidianを連携する手順との比較で見ると、CLI型とエディタ型の向き不向きがはっきりします。
企業のナレッジ基盤として採用する際の判断基準と見送り条件の整理
ここからは立場を明確にします。個人のPKM（知識管理）としてObsidian×Claude Codeを使うのはほぼ無条件で勧められます。一方で、組織の共有ナレッジ基盤としてそのまま横展開するのは、条件を満たさない限り見送るべきです。理由は連携の仕組みそのものにあります。個人側の基盤をどの層で組むかはPersonal Knowledge Base（PKB）とは？ローカルLLMで組む5層構成と実装判断で整理しており、capture・storage・embeddings・retrieval・interfaceの切り分けと、組織へ昇格させる条件をあわせて確認できます。
Local REST APIでVault全文を露出する構成のリスク
MCP接続の土台であるLocal REST APIは、Vault全体を読み書き可能なAPIとしてローカルに開きます。内蔵MCPサーバーはノートの中身に加えて、アクティブなファイルやコマンドパレットにも触れられる設計です。個人環境なら問題になりません。ところが、人事評価・顧客情報・未公開の契約メモが同じVaultに同居している組織では、AIへ渡すつもりのない機密まで検索対象に入ります。採用してよいのは、対象フォルダを機密と物理的に分離できる場合、またはAPIをローカルホストに閉じ外部到達を遮断できる場合に限るという判断です。暗号化されないHTTPポートを常時開けたままにする運用も避けます。逆に、監査ログや権限分離が規程で必須の部署のナレッジを、Vault全文APIのままAIへ開く構成は見送りが妥当です。ここは「便利だから」で押し切らず、情報区分を先に決めます。
個人のPKMと組織の業務ナレッジで連携方式を分ける判断の基準
方式選定も個人と組織で分けます。個人はVault直結かClaudianで軽く始めれば十分です。組織で共有知識をAIに載せるなら、Obsidianの生Vaultを共有するのではなく、公開してよい範囲だけを別リポジトリやシステムに切り出し、そこへエージェントを向けるのが安全です。部署ごとの閲覧権限を保ったままAIに社内文書を検索させる設計は、ナレッジベースとRAGの違いと権限制御の設計で扱っています。この「AIに見せてよい知識」と「見せてはいけない知識」の線引きと、その受け渡しの仕組み化は、Obsidianのプラグイン設定だけでは完結しません。社内ナレッジと生成AIをつなぐ基盤をどこまで内製し、どこから設計を委ねるか迷う段階なら、生成AI導入支援で要件から整理する選択肢があります。ツール名別のエージェント比較としてOpenCodeなど他のAIコーディングエージェントも候補に入れると、ベンダーロックを避けた設計を検討できます。
組織の共有ナレッジ基盤として横展開を見送るべき典型的なパターン
見送りの目安を具体化します。第一に、機密ノートと業務ノートが1つのVaultに混在し、分離工数を割けない場合。第二に、複数人が同じVaultを同時編集し、AIの自動更新と人の編集が衝突する運用が想定される場合。第三に、Obsidian Mobileでの利用が必須要件の場合（Claudianはデスクトップ限定で、公式CLIやMCPもデスクトップのObsidianが起動している前提です）。第四に、保守が止まったプラグイン（アーカイブ済みのMCP Tools for Obsidianなど）へ業務を依存させようとしている場合。これらに1つでも当たるなら、連携範囲を個人検証にとどめ、組織展開は情報設計を終えてからにします。過剰投資を避ける意味でも、まずは1人がVault直結で回し、効果を確かめてから広げる順序が堅実です。
よくある質問
Claude CodeとObsidianの連携でつまずきやすい点を、実際の検索質問に沿って5つ整理します。
Claude CodeとObsidianの連携にプラグインは必須ですか？
必須ではありません。最軽量のVault直結方式なら、Obsidian側にプラグインを一切入れず、VaultのフォルダでClaude Codeを起動するだけで読み書きできます。公式Obsidian CLIも設定の有効化だけで使え、プラグインは要りません。プラグインが要るのは、MCPサーバー接続（Local REST API）と、Obsidian画面内で完結させるClaudianの2方式です。まず直結で試し、画面統合や検索連携が欲しくなった時点でプラグイン方式へ移ると無駄がありません。
Claude DesktopとClaude Codeの連携は何が違いますか？
Claude DesktopはデスクトップアプリのコネクターでVaultフォルダを読み書きする方式で、設定が数クリックと軽く無料プランでも試せます。対してClaude CodeはターミナルのCLIで、Bashツールやスラッシュコマンドを使った自律的なエージェント操作ができ、利用には有料プランかConsoleアカウントが必要です。手軽さならDesktop、開発作業へ組み込むならClaude Code、という住み分けです。ブラウザ版のClaude.aiはローカルファイルを扱えない点に注意します。
obsidian claude code mcpの構成はどう組みますか？
ObsidianをMCPサーバー化し、Claude Codeをクライアントとして接続します。2026年9月時点では、Local REST APIプラグインでAPIキーを発行し、claude mcp add --transport httpでhttps://127.0.0.1:27124/mcp/とAuthorizationヘッダーを登録する流れです。claude mcp listで接続を確認し、ノートの内容が返れば疎通しています。つながらない場合は、プラグインの自己署名証明書を信頼させたかを最初に確認します。以前のMCP Tools for Obsidianはアーカイブ済みなので、新規構築では使いません。
ClaudianプラグインとMCP接続はどちらが向いていますか？
Obsidianの画面内でチャットも編集も完結させたいならClaudianが向きます。インライン編集や@mention参照をObsidian上で扱え、Claude CodeとCodex CLIなどを切り替えられる自由度が持ち味です。一方、既存のCLI運用や他のMCPツール群と揃えたい、Obsidianの検索インデックスを使いたいならMCP接続が向きます。どちらもデスクトップのObsidianが前提なので、モバイル利用が要件ならどちらの方式も現状は選べません。
連携させたVaultのメモが勝手に書き換わるのを防ぐには？
Vaultのルートに規約ファイルCLAUDE.mdを置き、AIの編集範囲を明文化するのが基本です。「確認なしの削除禁止」「ファイル名と列名の変更禁止」「完了時は西暦の日付を追記」といったルールを書いておくと、Claude Codeがそれを読んでから作業します。CLAUDE.mdは強制力を持たないため、触らせたくないフォルダは.claude/settings.jsonのpermissions.denyで拒否する設定が必要です。加えて、重要なVaultはGitでバージョン管理し、変更差分を後から確認できるようにしておくと、意図しない書き換えを巻き戻せます。
関連記事
- Claude Codeとは？できること・使い方・料金とコード解析の実力：連携の前提となるClaude Code本体の機能と料金を押さえられます。
- Claude Codeの使い方｜導入から権限とCLAUDE.md設定まで実務手順：Vault運用で使う権限設定とCLAUDE.mdの書き方を深掘りできます。
- GitHub MCPサーバーとは｜できること・toolset・リモート/ローカルのセットアップ：MCP接続方式の土台になるMCPサーバーの動作原理を理解できます。
- CursorとObsidianを連携する方法｜Vault直開き・MCP・CLIの設定手順：エディタ型AIとの連携と比較し、CLI型との向き不向きを見極められます。
- Obsidianカスタマイズ完全ガイド｜テーマ・外観設定・CSSスニペット：連携相手であるObsidian側の設定とVault構造を確認できます。
- Claude Skillsとは？SKILL.mdの書き方と使い方：obsidian-skillsのようなスキルをClaude Codeで読み込ませる仕組みを確認できます。
- OpenCodeとは？無料OSSのAIコーディングエージェント：Claude Code以外のエージェント選択肢を知り、ロックインを避けた設計を検討できます。
- herdrとは？複数のAIコーディングエージェントを1画面で束ねるRust製多重化ツール：Claude Codeを含む複数エージェントを並列運用する段階で、各エージェントの状態を可視化できます。
