Everything that changes the vault sits behind a tool set you switch on, and deletes, full replacements and global replacements each require an explicit confirmation. notes.validate lints a note before it is written, which removes the write-then-fix round trip that otherwise fills a vault with rule violations.
A Python server over a vault directory. The core is read-only and always on; writing, vault analysis, canvas, transcripts and semantic search are separate packs you enable per vault.
- Always on — vault.health, vault.diagnose, vault.context, client.roots and route.task, which recommends the prompts, skills and tools for a task
- Notes listed with pagination and glob filters, read singly or in batches, metadata-only reads, frontmatter, title or content search, and search by modified date — notes.list, notes.read, notes.read_many, notes.info, notes.get_frontmatter, notes.search, notes.search_by_date
- A note linted against the vault's own rules before it is written — notes.validate
- With notes_write: create, append, patch by exact match, replace, move and rename with every wikilink rewritten, delete, and preview-then-apply global replacement
- With vault_analysis: vault.stats, tags.analyze, links.analyze, links.backlinks, links.local_graph, links.find_orphans, links.find_broken with fuzzy suggestions, and a whole-vault lint that can auto-fix the regex rules
- With obsidianrag, canvas, kanvas and youtube: semantic questions through an external ObsidianRAG service, Canvas read and write, workflow boards, and transcript extraction
- Resources including obsidian://docs/agent-quickstart and obsidian://capabilities, so an agent orients itself in two calls
Uv, and OBSIDIAN_VAULT_PATH pointing at the vault you are willing to expose. Install straight from the repository with uvx --from git+https://github.com/Vasallo94/obsidian-mcp-server.git obsidian-mcp-server. Optional packs are named in OBSIDIAN_MCP_TOOL_SETS or in the vault's own .agents/vault.yaml.
One command — uvx --from git+https://github.com/Vasallo94/obsidian-mcp-server.git obsidian-mcp-server