obsidian-mcp

What it does

Obsidian MCP provides AI assistants with read and write access to Obsidian vaults through Claude Desktop. The server exposes tools to read, create, and edit individual notes; move or delete files; search vault contents; and manage tags. Multi-vault setups are supported via configuration.

Who it's for

Knowledge workers, researchers, and developers who maintain Obsidian vaults and want Claude to help search, organize, draft, or analyze notes. Most useful for large vaults where AI-assisted retrieval and bulk operations could save time.

Common use cases

• Search your vault for related notes and context during research or writing sessions
• Have Claude draft new notes from analysis or discussion, then refine them in Obsidian
• Bulk-rename or reorganize tags across your vault
• Create structured notes from extracted information or summaries
• Ask Claude to surface relevant existing notes when starting a new project

Setup pitfalls

• Requires an absolute vault path in the Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows) — relative paths will not work
• The server has unrestricted read and write access to all files in your vault. Back up before first use; the README emphasizes this is in active development with incomplete testing
• Requires Node.js 20 or higher
• Not actively maintained (last updated 347 days ago) — compatibility gaps are possible if your Obsidian version or vault structure has changed