Claude MarketplacesSubmit
bitbonsai avatar

Obsidian

bitbonsai/mcp-obsidian

Routes Claude operations across three backends for managing your Obsidian vault: MCP tools for reading and writing notes, Obsidian CLI for app-level actions like opening files, and git for backup workflows. The patch_note gotchas are worth studying since multi-match rejections and frontmatter string collisions will bite you if you're doing bulk edits. Git sync mode walks through preflight checks and asks targeted questions instead of making assumptions about your setup. Search returns minified JSON with a hard cap of 20 results, so don't expect exhaustive queries. If you're already using MCP servers with Obsidian, this codifies the routing logic and error recovery patterns you'd otherwise rebuild each session.

skills.sh installs
238
GitHub stars
1.3K
last updated
Jun 3, 2026
View on GitHub

Install

$ npx -y skills add bitbonsai/mcp-obsidian --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/mcp-obsidian
Categories
AI & Agent Building, Office & Documents
First seen
Jun 3, 2026

Recommended

More AI & Agent Building
1dicklesworthstone avatargclouddicklesworthstone/agent_flywheel_clawdbot_skills_and_integrationsGoogle Cloud Platform CLI - manage GCP resources including Compute Engine, Cloud Run, GKE, Cloud Functions, Storage, BigQuery, and more.238skills.sh installs
2jorgealves avatarhipaa-compliance-guardjorgealves/agent_skillsAudits HealthTech applications for HIPAA technical safeguards like encryption and audit logging. Use when reviewing healthcare infrastructure or ensuring PHI is238skills.sh installs
3meleantonio avatarlit-review-assistantmeleantonio/awesome-econ-ai-stuffSearch, summarize, and synthesize economics literature238skills.sh installs
4specstoryai avatarspecstory-project-statsspecstoryai/agent-skillsFetch project statistics from SpecStory Cloud. Run when user says "get project stats", "show SpecStory stats", "project statistics", "how many sessions", or "Sp238skills.sh installs
5lllllllama avatarexplore-codelllllllama/ai-paper-reproduction-skillexplore code237skills.sh installs
6siviter-xyz avatartypescriptsiviter-xyz/dot-agentTypeScript standards and best practices with modern tooling. Use when working with TypeScript or TypeScript React files.237skills.sh installs