+ From basic setup to advanced configurations, here's how to customize MCPVault for your workflow. +
++ The simplest way to get started. Just point to your vault and you're ready to go. +
+{
+ "mcpServers": {
+ "obsidian": {
+ "command": "npx",
+ "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Documents/MyVault"]
+ }
+ }
+}+ Fine-tune MCPVault's behavior with custom settings, logging, and performance options. +
+{
+ "mcpServers": {
+ "obsidian": {
+ "command": "npx",
+ "args": [
+ "@bitbonsai/mcpvault@latest",
+ "/Users/you/Documents/MyVault",
+ "--log-level", "debug",
+ "--max-search-results", "50",
+ "--backup-enabled", "true",
+ "--read-only", "false"
+ ],
+ "env": {
+ "MCP_OBSIDIAN_CACHE_SIZE": "100MB",
+ "MCP_OBSIDIAN_TIMEOUT": "30s"
+ }
+ }
+ }
+}+ Manage multiple Obsidian vaults simultaneously. Perfect for separating work, personal, and project notes. +
+{
+ "mcpServers": {
+ "obsidian-work": {
+ "command": "npx",
+ "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Work/Notes"]
+ },
+ "obsidian-personal": {
+ "command": "npx",
+ "args": ["@bitbonsai/mcpvault@latest", "/Users/you/Personal/Journal"]
+ },
+ "obsidian-research": {
+ "command": "npx",
+ "args": [
+ "@bitbonsai/mcpvault@latest",
+ "/Users/you/Research/Papers",
+ "--read-only", "true"
+ ]
+ }
+ }
+}+ Control exactly what AI can access with powerful inclusion and exclusion filters. +
+{
+ "mcpServers": {
+ "obsidian": {
+ "command": "npx",
+ "args": [
+ "@bitbonsai/mcpvault@latest",
+ "/Users/you/Documents/MyVault",
+ "--include-patterns", "*.md,!private/**",
+ "--exclude-tags", "personal,draft",
+ "--include-tags", "work,project",
+ "--date-range", "2024-01-01,2024-12-31"
+ ]
+ }
+ }
+}+ See how MCPVault compares to plugin-based alternatives and direct file manipulation. + Purpose-built for Obsidian means better safety, performance, and intelligence. +
+Common setup and safety questions.
+{item.a}
++ {description} +
++ Designed for safety, performance, and developer experience. Every + feature gives AI intelligent access without compromising your data. +
++ Your assistant. Your notes. Zero friction. +
+ + ++ This MCP server lets Claude, ChatGPT+, and other assistants access your vault. Locally, safe frontmatter, no cloud sync. +
+ + + + + + + + ++ Practical prompts you can try with your AI assistant and MCPVault. +
+{example.prompt}
++ {example.description} +
++ Once MCPVault is set up, these prompts demonstrate search, read, and write operations in a single flow. +
+ + + Get Started Now + ++ Watch how AI assistants intelligently interact with your Obsidian vault. + These examples show real conversations and outcomes. +
+{activeExample.claude}
+
+ 
+ 
+ 
+ 
+ 
+
+ {part}
+
+ );
+ })}
+ + Ready to experience this level of AI-powered note management? +
+ + + Get Started Now + +
+ {part}
+
+ );
+ })}
+
+ Combines MCP server safety with Obsidian CLI context.
+
+ One skill that routes each operation to the right backend.
+
{installCmd}
+
+ {card.desc}
++ Each operation maps to exactly one backend. The skill picks the right one automatically. +
+ +| Operation | +MCP | +Obsidian CLI | +Git | + +
|---|---|---|---|
| {route.operation} | ++ {route.mcp ? ( + ✓ + ) : ( + — + )} + | ++ {route.app ? ( + ✓ + ) : ( + — + )} + | ++ {route.git ? ( + ✓ + ) : ( + — + )} + | + +
+ The skill routes by intent. MCP is the safe default for vault edits, Obsidian context is used for app-specific actions, and Git CLI handles sync/backup. +
+Open for routing rules, preflight logic, and an end-to-end example
+git --version
+git rev-parse --is-inside-work-tree
+git config user.name
+git config user.email
+git remote -vIf any check fails, ask one targeted setup question with a recommended default.
++ Handles all file I/O: reading, writing, searching, patching, and organizing notes. Enforces path sandboxing, validates inputs, and performs atomic operations. The safe default for any vault mutation. +
++ Bridges the gap for operations that need the running desktop app: opening notes in the editor, triggering plugin commands, exporting to PDF via Obsidian URI schemes. +
++ Plain git for vault syncing across devices. No Obsidian Sync subscription required. Works headlessly via cron, launchd, or CI — no app needs to be running. +
+Free alternative to Obsidian Sync — expand for setup details
+
+ An Obsidian vault is just a folder of markdown files. You can git init inside it, add a remote, and push/pull like any repo. No proprietary format, no paid service.
+
# cron job or launchd plist
+cd /path/to/vault
+git add -A
+git commit -m "backup $(date +%Y-%m-%d)"
+git push+ No Obsidian CLI required. Works on servers, NAS, or any headless machine. +
++ The Obsidian Git community plugin (8k+ stars) adds GUI-driven auto-sync from within the app: auto-commit on interval, pull on startup, push on close, and a source control sidebar. +
+.gitignore or Git LFS
+ .obsidian/workspace.json to .gitignore
+ Recommended .gitignore
+.obsidian/workspace.json
+.obsidian/workspace-mobile.json
+.obsidian/plugins/obsidian-git/data.json
+.trash/+ Three patterns for combining MCP and Obsidian in a single session. +
+{wf.description}
+{rule.description}
++ Install the skill to teach your AI assistant the Obsidian workflow. +
+ +.claude/
+ skills/
+ obsidian/
+ SKILL.md # Gotchas, error recovery, index
+ resources/
+ tool-patterns.md # Per-tool response shapes and recipes
+ obsidian-conventions.md # Vault structure, wikilinks, tags
+ git-sync.md # Git backup/sync workflows---
+name: obsidian
+description: >
+ Activate when the user mentions their
+ Obsidian vault, notes, tags, frontmatter,
+ daily notes, backup, or sync. Route
+ operations across MCP, Obsidian CLI/app
+ actions, and git sync with safe defaults.
+metadata:
+ version: "2.0"
+ author: bitbonsai
+---+ Install MCPVault and connect your vault to any AI assistant. +
+ + + Install Now + ++ Get MCPVault running in seconds with any MCP-compatible platform +
++ + + Optional no-path mode: + if your client starts MCPVault from inside your vault folder, + you can omit the vault path and use current working directory. + +
+
+ npx @bitbonsai/mcpvault@latest
+
+
+ "args": ["@bitbonsai/mcpvault@latest"]
+
+
+
+
+ Supported note file types: .md,
+ .markdown,
+ .txt,
+ .base, and
+ .canvas.
+
+
+ + + No pre-installation needed! npx automatically downloads + and runs the server when needed. + +
+
+ ~/Library/Application\ Support/Claude/claude_desktop_config.json
+
+ %APPDATA%\Claude\claude_desktop_config.json
+ ~/.claude.json
+ claude mcp add-json --scope user for global access
+ ~/Library/Application Support/ChatGPT/chatgpt_config.json
+ %APPDATA%\ChatGPT\chatgpt_config.json
+ ~/.gemini/settings.json
+ opencode.json
+ ~/.config/opencode/opencode.json
+ ~/.codex/config.toml
+ %USERPROFILE%\.codex\config.toml
+ Option
+ and choose
+ Copy "..." as Pathname.
+ Shift,
+ right-click your vault folder, and choose
+ Copy as path.
+ pwd.
+
+ Replace /path/to/your/vault
+ with that full absolute path.
+
+ + Optional CWD mode +
++ You can omit the vault path entirely when your client starts this + server from inside your vault directory. In that case, + MCPVault uses the current working directory as vault root. +
+
+ npx @bitbonsai/mcpvault@latest
+
+
+ npm start
+
+ + + MCP Inspector provides a web UI to test all MCP methods + interactively. +
+
+
+
+ Works with all MCP-compatible platforms: Claude Desktop, ChatGPT+, Claude Code, OpenCode, Gemini CLI, Cursor IDE,
+ Windsurf, and more coming soon!
+
+
Use the same configuration with your platform's MCP server
+ settings.
+
+ + What "private" means: +
+ ++ For commercial Claude users: Your data won't be used for AI + training. +
++ Restart your AI platform and you'll see MCPVault connected. Your + AI assistant can now safely read, search, and manage your Obsidian + vault. +
++ + JUST LAUNCHED + Obsidian Skill routing is now live with MCP + Obsidian context + Git CLI sync, including preflight checks and setup guidance. + See skill flows +
+
+ v0.11.2 (April 2026): delete_note now supports soft-delete with trashMode: none (permanent), local (move to .trash/ inside vault), or system (OS trash).
+ (#91)
+
YYYY-MM-DD, quoted strings keep their quotes, and HH:MM values are no longer misread as sexagesimal integers.
+ (#77)
+ list_all_tags tool scans the vault for all frontmatter tags and inline #hashtags with occurrence counts. Obsidian skill now routes to CLI for active file, daily notes, backlinks, and open-in-editor.
+ (#80)
+ createServer() factory for library consumers. TypeScript declarations exported.
+ (#84)
+ @bitbonsai/mcpvault on npm at Obsidian's request. Update your config: replace mcpvault with @bitbonsai/mcpvault.
+ get_vault_stats now handles dotted folder names correctly
+ (PR #42),
+ note tools now support .base and .canvas
+ (PR #53),
+ string frontmatter inputs are now handled safely
+ (PR #47),
+ vault path is now optional for CLI usage (defaults to current working directory)
+ (#50),
+ and dependency refreshes for the MCP SDK and Node types are merged
+ (PR #43,
+ PR #44)
+ move_file tool for binary-safe file moves with explicit path confirmation,
+ binary filenames now visible in directory listings
+ (#21)
+
+
|