Obsidian MCP

AIアシスタント（Claude、Cursor など）に Obsidian ボールトへのアクセスを提供する MCP（Model Context Protocol）サーバーです。フォルダーの移動、ノートの読み取り、作成、編集、移動、名前変更、削除を、すべて AI チャットから行えます。

要件

• Python 3.10+

• uv（推奨）または pip

• ローカルマシン上の Obsidian ボールト

Related MCP server: mcp-obsidian

インストール

# Clone the repo
git clone https://github.com/your-username/obsidian-mcp
cd obsidian-mcp

# Copy the env template and set your vault path
cp .env.example .env

.env を編集し、ボールトのパスを設定します:

OBSIDIAN_VAULT_PATH="/Users/you/Documents/MyVault"

Obsidian でボールトのパスを確認するには: 設定 → 情報 → ボールトのパス。

サーバーの実行

開発（MCP Inspector UI 付き）

uv run mcp dev server.py

これにより、ブラウザで MCP Inspector が開き、すべてのツールを対話的にテストできます。

本番

uv run server.py

Cursor への接続

これを .cursor/mcp.json（または Cursor のグローバル MCP 設定）に追加します:

{
  "mcpServers": {
    "obsidian": {
      "command": "python",
      "args": ["/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

/absolute/path/to/obsidian-mcp/server.py を、お使いのマシン上の server.py の実際のパスに置き換え、/path/to/your/vault をボールトのパスに置き換えてください（Obsidian で確認できます: 設定 → 情報 → ボールトのパス）。

Claude Desktop への接続

これを claude_desktop_config.json に追加します:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "/absolute/path/to/obsidian-mcp/server.py"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

利用可能なツール

すべてのパスはボールトのルートからの相対パスです（例: "Projects/App/roadmap.md"）。

ライセンス

MIT