Obsidian
The Obsidian MCP server enables AI assistants to interact with Obsidian vaults through a set of tools for managing notes, directories, and tags. It provides capabilities to read, create, edit, delete, and move notes, as well as search vault contents and manage tags (add, remove, rename). The server solves the problem of integrating Obsidian note-taking systems with AI workflows, allowing Claude and other AI assistants to directly access and manipulate vault contents.
- GitHub stars
- 704
- tools
- 12
- last updated
- Feb 7, 2026
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
obsidian_list_vaultsList configured vault ids without exposing host paths.
List configured vault ids without exposing host paths.
No parameter schema in public metadata yet.
obsidian_read_noteRead a bounded page of a note and return its SHA-256 `etag`.
Read a bounded page of a note and return its SHA-256 `etag`.
No parameter schema in public metadata yet.
obsidian_create_noteAtomically create a note without overwriting.
Atomically create a note without overwriting.
No parameter schema in public metadata yet.
obsidian_edit_noteAppend, prepend, or replace exact note content.
Append, prepend, or replace exact note content.
No parameter schema in public metadata yet.
obsidian_delete_noteMove a note to MCP trash or permanently delete it with explicit confirmation.
Move a note to MCP trash or permanently delete it with explicit confirmation.
No parameter schema in public metadata yet.
obsidian_move_noteMove or rename a note and update unambiguous backlinks transactionally.
Move or rename a note and update unambiguous backlinks transactionally.
No parameter schema in public metadata yet.
obsidian_create_directoryTransactionally create a directory inside a vault.
Transactionally create a directory inside a vault.
No parameter schema in public metadata yet.
obsidian_search_vaultSearch content, filenames, or tags with bounded cursor pagination.
Search content, filenames, or tags with bounded cursor pagination.
No parameter schema in public metadata yet.
obsidian_add_tagsAdd tags to one or more notes atomically.
Add tags to one or more notes atomically.
No parameter schema in public metadata yet.
obsidian_remove_tagsRemove exact, nested, or wildcard-selected tags atomically.
Remove exact, nested, or wildcard-selected tags atomically.
No parameter schema in public metadata yet.
obsidian_rename_tagRename a tag across the vault atomically.
Rename a tag across the vault atomically.
No parameter schema in public metadata yet.
obsidian_manage_tagsUnified add/remove tag workflow using the same implementation.
Unified add/remove tag workflow using the same implementation.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Obsidian MCP
A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.
Version 2 supports both MCP 2026-07-28 and 2025-era clients by default, and requires Node.js 22 or newer. It works directly with Markdown files, so Obsidian does not need to be open. Legacy protocol and v1 positional-path compatibility are deprecated and print exact migration instructions to stderr.
[!IMPORTANT] MCP clients can invoke destructive tools. Back up important vaults, review client permission prompts, and use revision preconditions for concurrently edited notes.
Quick start
Node.js 22 or newer is required:
node --version # v22 or newer
Run with npx without installing the package globally. Pinning the major version receives compatible 2.x updates without automatically crossing a future major version:
npx -y obsidian-mcp@2 serve --vault notes=/absolute/path/to/vault
Configure an MCP client to launch the same command over stdio:
Details
- Repository
- github.com/stevenstavrakis/obsidian-mcp
- Category
- Documents & Knowledge
Related Documents & Knowledge MCP servers
View all
Obsidian Claude Codeiansinnott/obsidian-claude-code-mcpProvides a dual-transport MCP server for Claude Code and Claude Desktop to read and write your Obsidian vault via MCP.287stars
MCP LogSeq Serverergut/mcp-logseqMCP server to interact with LogSeq via its Local HTTP API - enabling AI assistants like Claude to seamlessly read, write, and manage your LogSeq graph.267stars
Zotero MCPkujenga/zotero-mcpSearch your Zotero library, retrieve item metadata, and read full text from AI assistants.162stars
Markdown Vault MCPpvliesdonk/markdown-vault-mcpGeneric markdown vault MCP with hybrid search38stars
Agent Knowledgekeshrath/agent-knowledgeCross-session memory for AI agents - knowledge graph, scoring, semantic search19stars