local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags within Obsidian.

Obsidian MCP サーバー

AI アシスタントが Obsidian Vault と対話できるようにし、メモやタグの読み取り、作成、編集、管理のためのツールを提供するMCP (Model Context Protocol)サーバー。

警告！！！

このMCPには読み取りと書き込みのアクセス権があります（許可した場合）。obsidian-mcpを使用してノートを管理する前に、Obsidian Vaultを必ずバックアップしてください。Gitの使用をお勧めしますが、どのバックアップ方法でも問題ありません。これらのツールはテスト済みですが、完全ではありません。また、このMCPは現在開発中です。

特徴

保管庫内のメモを読んだり検索したりする
新しいメモとディレクトリを作成する
既存のメモを編集する
メモの移動と削除
タグの管理（追加、削除、名前の変更）
保管庫の内容を検索

要件

Node.js 20 以上 (それ以下でも動作するかもしれませんが、テストしていません)
黒曜石の金庫

インストール

手動でインストールする

Claude Desktop 構成に追加:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "obsidian": {
            "command": "npx",
            "args": ["-y", "obsidian-mcp", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

/path/to/your/vault Obsidian Vaultへの絶対パスに置き換えてください。例：

MacOS/Linux:

"/Users/username/Documents/MyVault"

ウィンドウズ:

"C:\\Users\\username\\Documents\\MyVault"

設定を保存したら、Claude for Desktopを再起動してください。サーバーが接続されたことを示すハンマーアイコンが表示されます。

接続の問題がある場合は、次のログを確認してください。

MacOS: ~/Library/Logs/Claude/mcp*.log
Windows: %APPDATA%\Claude\logs\mcp*.log

Smithery経由でインストール

警告：私はSmitheryとは一切関係ありません。実際に使用してテストしたことはなく、可能であれば手動でインストールすることをお勧めします。

Smithery経由で Claude Desktop 用の Obsidian を自動的にインストールするには:

npx -y @smithery/cli install obsidian-mcp --client claude

発達

# Clone the repository
git clone https://github.com/StevenStavrakis/obsidian-mcp
cd obsidian-mcp

# Install dependencies
npm install

# Build
npm run build

次に、Claude Desktop 構成に追加します。

{
    "mcpServers": {
        "obsidian": {
            "command": "node",
            "args": ["<absolute-path-to-obsidian-mcp>/build/main.js", "/path/to/your/vault", "/path/to/your/vault2"]
        }
    }
}

利用可能なツール

read-note - メモの内容を読む
create-note - 新しいノートを作成する
edit-note - 既存のメモを編集する
delete-note - メモを削除する
move-note - ノートを別の場所に移動する
create-directory - 新しいディレクトリを作成する
search-vault - 保管庫内のノートを検索
add-tags - メモにタグを追加する
remove-tags - ノートからタグを削除する
rename-tag - すべてのノートのタグの名前を変更する
manage-tags - タグの一覧表示と整理
list-available-vaults - 利用可能なすべてのボールトを一覧表示します（複数のボールトの設定に役立ちます）

ドキュメント

追加のドキュメントは、 docsディレクトリにあります。

creating-tools.md - 新しいツールを作成するためのガイド
tool-examples.md - 利用可能なツールの使用例

安全

このサーバーはObsidian Vaultディレクトリへのアクセスを必要とします。サーバーを設定する際は、以下の点にご注意ください。

目的のVaultディレクトリへのアクセスのみを提供する
ツールアクションを承認する前に確認する

トラブルシューティング

よくある問題:

Claude Desktop にサーバーが表示されない
- 設定ファイルの構文を確認する
- ボールトパスが絶対パスであり、存在していることを確認してください
- Claudeデスクトップを再起動します
権限エラー
- ボールトパスが読み取り/書き込み可能であることを確認する
- 保管庫内のファイル権限を確認する
ツール実行の失敗
- Claude Desktop のログを次の場所で確認してください:
  - macOS: ~/Library/Logs/Claude/mcp*.log
  - Windows: %APPDATA%\Claude\logs\mcp*.log

ライセンス

マサチューセッツ工科大学

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI アシスタントが Obsidian Vault と対話できるようにし、メモやタグの読み取り、作成、編集、管理のためのツールを提供します。