obsidian-mcp-pro

The most feature-complete MCP server for Obsidian vaults.

⭐ Please star us on GitHub — it helps us reach more users!

💙 Support this project — obsidian-mcp-pro is free and open-source. If it saves you time, consider supporting continued development via the Sponsor button above.

Give AI assistants deep, structured access to your Obsidian knowledge base. Read, write, search, tag, analyze links, traverse graphs, and manipulate canvases — all through the Model Context Protocol.

Every one of the 23 tools ships with rich descriptions, typed schemas, human-readable titles, and safety annotations (readOnlyHint, destructiveHint, idempotentHint) so your agent picks the right tool, passes the right arguments, and handles results correctly — with an average 4.40/5 score and all 23 tools rated A on Glama's quality index.

Features

Read & Search

• Full-text search across all vault notes
• Read individual notes with frontmatter parsing
• List and filter notes by folder, date, or pattern
• Search by frontmatter fields and values
• Retrieve daily notes automatically

Write & Modify

• Create new notes with frontmatter and content
• Append or prepend content to existing notes
• Update frontmatter properties programmatically (merges — unlisted keys are preserved)
• Move and rename notes (pair with find_broken_links to surface any references that need updating)
• Delete notes safely — moved to the vault's .trash folder by default, with an optional permanent flag

Tags

• Build and query a complete tag index
• Search notes by single or multiple tags

Links & Graph

• Get backlinks (what links to a note)
• Get outlinks (what a note links to)
• Find orphan notes with no inbound or outbound links
• Detect broken links pointing to non-existent notes
• Traverse graph neighbors to a configurable depth

Canvas

• Read .canvas files with full node and edge data
• Add new nodes (text, file, link, group) to canvases
• Add edges between canvas nodes
• List all canvases in the vault

MCP Resources

• obsidian://note/{path} — read any note by its vault-relative path
• obsidian://tags — retrieve the full tag index as JSON
• obsidian://daily — get today's daily note content

Quick Start

Using Obsidian? There's also an Obsidian plugin that runs this server inside the app with a ribbon toggle and settings UI — no config-file editing. Recommended for most users.

One-command install (Claude Desktop / Cursor)

npx -y obsidian-mcp-pro install

This merges an entry into your claude_desktop_config.json (or ~/.cursor/mcp.json with --client=cursor), backs up the previous file, and prints next steps. Works on macOS, Windows, and Linux.

Pin a specific v

... View full README on GitHub