Claude MarketplacesSubmit
bitbonsai avatar

Obsidian

bitbonsai/mcpvault

Routes Obsidian vault operations through the right backend without you thinking about it. MCP handles reading, writing, and searching notes. Git commands take over when you ask to sync or backup. The Obsidian CLI opens notes in the app when you need that context. The real value is in the gotchas section: patch_note fails on multi-match by default, search returns minified JSON with a 20-result cap, and delete_note requires exact path confirmation with zero tolerance for typos. If you're bouncing between vault automation and manual editing, this keeps the handoff clean and documents where each tool will trip you up.

skills.sh installs
1.7K
GitHub stars
1.7K
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add bitbonsai/mcpvault --skill obsidian --agent claude-code

Installs into .claude/skills of the current project.

Files

Obsidian Skill

Routing Policy

Use the backend that best matches user intent:

  1. MCP (default for vault data operations)

    • Read/write/patch/search notes
    • Move/rename notes with move_note, then explicitly repair backlinks
    • Frontmatter and tag updates
    • Metadata and batch note operations

  2. Obsidian CLI/App context (only when app context is needed)

    • Open a note in Obsidian from URI
    • Trigger app/plugin workflows that MCP cannot perform

  3. CLI git (sync/backup workflows)

    • Initialize repo, configure remote, commit, pull, push
    • Periodic or manual vault backup/sync requests

When a request is ambiguous, pick MCP first unless the user explicitly asks for sync/backup/git/app behavior.

Safe Note Rename Workflow

Use MCP move_note for every note move or rename, even when Obsidian is running. Do not invoke the Obsidian CLI move command automatically: delayed link rewrites can apply stale byte offsets to notes edited after the move began, silently corrupting unrelated content (#176). Reconsider CLI moves only after an upstream fix has been independently retested.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/bitbonsai/mcpvault
Categories
Git & Pull Requests, AI & Agent Building, CLI & Terminal, Office & Documents
First seen
May 16, 2026

Recommended

More Git & Pull Requests
1lingzhi227 avatarpaper-assemblylingzhi227/agent-research-skillsOrchestrate the full paper pipeline end-to-end. Manage state propagation between phases (literature → plan → code → experiments → figures → tables → writing → r1.6Kskills.sh installs
2refoundai avatarrunning-design-reviewsrefoundai/lenny-skillsHelp users run effective design reviews and critiques. Use when someone is giving design feedback, establishing design review processes, struggling to evaluate 1.6Kskills.sh installs
3yonatangross avatardevops-deploymentyonatangross/orchestkitUse when setting up CI/CD pipelines, containerizing applications, deploying to Kubernetes, or writing infrastructure as code. DevOps & Deployment covers GitHub 1.6Kskills.sh installs
4rshankras avatarmacos-developmentrshankras/claude-code-apple-skillsComprehensive macOS development guidance including Swift 6+, SwiftUI, SwiftData, architecture patterns, AppKit bridging, and macOS 26 Tahoe APIs. Use for macOS 1.6Kskills.sh installs
5redwoodjs avataragent-ciredwoodjs/agent-ciRun GitHub Actions CI locally with Agent CI to validate changes before pushing. Use when testing, running checks, or validating code changes.1.6Kskills.sh installs
6neo4j-contrib avatarneo4j-cypher-skillneo4j-contrib/neo4j-skillsGenerates, optimizes, and validates Cypher 25 queries for Neo4j 2025.x and 2026.x. Use when writing new Cypher queries, optimizing slow queries, graph pattern m1.6Kskills.sh installs