mcp-obsidian-cli

mcp-obsidian-cli

あなたの思考はObsidianではなく、Claude Desktopから始まります。調査し、下書きを作り、モデルと議論し、保存しておきたいものがあれば「これを自分のVaultに保存して」と伝えます。適切な場所に保存されます。テンプレート、プロパティ、今日の日次ノートに沿って、リンクグラフにもつながります。タブの切り替えも、コピー＆ペーストも不要です。

インストールしますか？ インストールから始めてください。Claude Codeでプロンプトを1つ実行すれば、セットアップ全体が完了します。

機能は2つです。

• 取り込み — 会話を、本来あるべき場所に保存された実際のノートに変換します。
• 拡張 — Vaultにすでにある情報（バックリンク、全文検索）をチャットに取り込み、ノートの作成や更新に役立てます。

Obsidianを起動しておく必要があります。最小化しておけるので、Obsidianに切り替える必要はありません。

Claude Codeから使う場合は、ネイティブのobsidian-cliスキルのほうが適しています。MCPレイヤーを介さず、CLIを直接使えます。インストールは別途必要です。以下のプロンプトはClaude Codeで実行してください。

インストール

以下のプロンプトをClaude Codeで実行してください。Nodeを確認し、Obsidian CLIを有効にして、Claude Desktopの設定を書き込み、接続を検証します。設定を手動で編集するのは、この方法で失敗した場合だけにしてください。

Fetch https://raw.githubusercontent.com/stonematt/mcp-obsidian-cli/master/docs/INSTALL.md
and follow it end to end to install the mcp-obsidian-cli MCP server for my Claude Desktop.
Ask me for my Obsidian vault name and folder path, then handle everything else — check Node,
enable the Obsidian CLI, edit my Claude Desktop config, and verify it works.

失敗時のケースも含む手順の詳細は、**docs/INSTALL.md**をご覧ください。

サーバーを直接実行する。 サーバーをターミナルで起動します。何もインストールされません。

npx mcp-obsidian-cli

必要条件

インストール用プロンプトが以下をそれぞれ確認します。参照用として記載しています。

• Obsidianが起動していて、コマンドラインインターフェースが有効になっていること（設定 → 一般 → 詳細設定 → コマンドラインインターフェース）。CLIはObsidianに組み込まれているため、追加でインストールする必要はありません。
• obsidian-cliにアクセスできること。macOSではObsidianアプリのバンドル内から自動検出されるため、設定は不要です。LinuxとWindowsでは自動検出されないため、OBSIDIAN_CLI_PATHにバイナリのパスを指定してください。
• Node.js >= 18

仕組み

このサーバーは、Obsidian CLI のコマンドを MCP ツールとして公開します。汎用のパススルーツールで CLI の全機能（80 以上のコマンド）を利用できるほか、よく使われる操作向けの型付き便利ツールも用意されています。

汎用の obsidian ツールにより、MCP サーバーが CLI に遅れを取ることはありません。新しい CLI コマンドは、サーバーを更新しなくてもすぐに使えます。

できること

実行中の Obsidian インスタンスと通信するため、Obsidian が認識する方法で Vault を操作できます。

• 解決済みリンクのグラフと検索インデックス全体を対象に、バックリンクと全文検索を行います（拡張側の機能）。
• ノートの作成や更新時に、Templater テンプレートと型付きのフロントマターのプロパティを利用できます。
• 日次ノート、タスク検索、タグの件数を扱えます。
• 汎用パススルーで80 以上のコマンドを利用できます。API キーも REST プラグインも不要です。公式の Obsidian CLI だけで使えます。

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian-cli"],
      "env": {
        "OBSIDIAN_VAULT": "my-vault"
      }
    }
  }
}

環境変数

設定ファイル

サーバーは YAML 設定ファイルから設定を読み込めます。

• デフォルト：~/.config/mcp-obsidian-cli/config.yaml
• XDG_CONFIG_HOME を使用する場合：$XDG_CONFIG_HOME/mcp-obsidian-cli/config.yaml

設定ファイルの形式：

vault: "my-vault"
cliPath: "obsidian-cli"
timeoutMs: 15000

設定の優先順位：環境変数 > 設定ファイル > ハードコードされたデフォルト値

バグ／リクエスト

https://github.com/stonematt/mcp-obsidian-cli/issues/new/choose からイシューを作成してください。バグ報告テンプレートでは、バージョン、MCP クライアント、ツール呼び出し、応答を記入します。すぐに記入でき、迅速に対応できます。

ライセンス

MIT

@stonematt がメンテナンスしています
MIT License の下でライセンスされています

商標に関する注意：「Obsidian」は Obsidian Publishing, Inc. の商標です。このプロジェクトは Obsidian Publishing と提携しておらず、同社の承認も受けていません。