Your Obsidian vault, now readable by robots that ask nicely

What it does

MCPVault is a local Node.js server that exposes your Obsidian vault to any AI assistant speaking the Model Context Protocol. It handles the full lifecycle of notes—read, write, patch, move, delete, search, tag management, and frontmatter updates—while keeping your .obsidian directory and other system files out of reach. No plugins, no cloud sync, no vendor-specific integrations.

The interesting bit

The safety layer is the real craft. It uses gray-matter with AST-aware updates so untouched frontmatter fields keep their original formatting, and it requires explicit confirmation before deletions. The author also aggressively minifies JSON responses (40–60% smaller tokens) because every byte counts when you’re feeding a context window.

Key highlights

• 14 MCP methods: file ops, batch reads, BM25-ranked search, tag management, vault stats
• Write modes: overwrite, append, prepend
• Zero Obsidian plugins required; works on any local vault structure
• Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, IntelliJ 2025.1+, and others
• Optional prettyPrint: true for debugging the token-shrunk responses

Caveats

• ChatGPT Desktop support requires Enterprise/Education/Team tier; individual Plus users are out of luck
• Requires Node.js 18+ and runs locally—no remote access story
• The README is thorough to a fault; finding the actual feature list means scrolling past configuration blocks for six different clients

Verdict

Worth it if you already live in Obsidian and want your AI assistant to actually use your knowledge base instead of hallucinating it. Skip if you’re hoping for a hosted solution or your primary AI tool is ChatGPT Plus.