obsidian-mcp (Python)

ファイルシステムへの直接アクセスにより、ローカルのObsidianボールトへの読み書きアクセスをLLMクライアント（例：Claude Desktop）に提供するPython製MCP（Model Context Protocol）サーバーです。Obsidian Local REST APIプラグインも、HTTPも、認証トークンも不要です。

これはobsidian-mcp（TypeScript）のPython移植版で、いくつかの意図的な修正と簡素化を加えた上で機能的に同等です。詳細な根拠については、Plans/review-the-typescript-obsidian-mcp-parsed-shamir.mdとISA.mdを参照してください。

警告: このサーバーはボールトへの読み書きアクセス権を持ちます。使用前に（例：git経由で）ノートをバックアップしてください。

要件

• Python 3.11以上

• uv

• Obsidianボールト（Obsidianで少なくとも一度は開かれたディレクトリ、つまり.obsidian/app.jsonを含むディレクトリ）

• macOSまたはLinux（Windowsはサポートされていません — ISAの「Out of Scope」を参照）

Related MCP server: Obsidian MCP Server

インストールと実行

uv sync
uv run obsidian-mcp /path/to/your/vault [/path/to/another/vault ...]

ボールト名は各ディレクトリのベース名から自動的に生成されます（小文字化され、英数字以外の文字はハイフンに変換され、重複には数値の接尾辞が付きます）。最大10個のボールトまで対応。ボールトのパスは互いにネストしていてはなりません。

Claude Desktopの設定

claude_desktop_config.jsonを編集します（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/py-obsidian-mcp", "obsidian-mcp", "/path/to/your/vault"]
    }
  }
}

ツール

read-note、create-note、edit-note（追加/先頭挿入/置換/削除）、delete-note（デフォルトでは.trash/へのソフト削除）、move-note、create-directory、search-vault（コンテンツ/ファイル名/タグ検索、オプションのmax_results付き）、add-tags、remove-tags、rename-tag（ボールト全体、階層を保持）、list-available-vaults。

また、obsidian-vault://リソーススキーム（ボールトの一覧/情報）とlist-vaultsプロンプトも公開しています。

開発

uv sync --all-extras
uv run pytest -q
uv run ruff check src tests

セキュリティに関する注意事項

• すべてのツールは、対象パスがボールト内に留まることを検証します（src/obsidian_mcp/utils/path_safety.py）。シンボリックリンクを考慮した包含チェックも含みます。

• TypeScript版オリジナルには、この包含チェックが実質的に何もしないという確認済みのバグがありました（非同期の検証関数がawaitなしで呼び出されていました）。この移植版のパス安全関数はすべて同期であり、構造的にその種のバグを防ぎます。