obsidian

Automate safe read, write, and search operations for an Obsidian vault.

1.6k|122|Updated Sep 21, 2025
One-click install
npx skills add https://github.com/bitbonsai/mcpvault --skill obsidian-bitbonsai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/bitbonsai/mcpvault/tree/main/skills/obsidian
Command: npx skills add https://github.com/bitbonsai/mcpvault --skill obsidian-bitbonsai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill gives you safe AI control over an Obsidian vault, reducing manual note editing mistakes and protecting YAML frontmatter integrity while you work.

Core Features & Use Cases

  • Safe note operations: Read, write, patch, move, search, and organize notes without breaking vault structure.
  • Vault metadata management: Update frontmatter, tags, daily notes, backlinks, and unresolved links with Obsidian-aware conventions.
  • App and sync workflows: Use Obsidian CLI for active-file and plugin-driven tasks, and use git for backup and synchronization with preflight checks.
  • Example: Ask it to rename a project note, add tags, and sync the vault to git after the change.

Quick Start

Tell the assistant to connect to your Obsidian vault and read, update, search, or sync notes using the safest available route for your request.

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely automate Obsidian vault edits without breaking YAML frontmatter?

To safely automate Obsidian vault edits, this Skill enforces YAML validation, exact path confirmations, and unique patch matching before writing. This prevents manual note editing mistakes and protects frontmatter integrity during automated read, write, and patch operations.

Can I use AI to update Obsidian daily notes, backlinks, and unresolved links?

Yes, you can use AI to update daily notes, backlinks, and unresolved links. The Skill applies Obsidian-aware conventions to manage vault metadata, ensuring tags and links remain structurally consistent across your notes.

What is the best way to sync an Obsidian vault to git after renaming a project note?

The best way to sync an Obsidian vault to git is using the Skill's non-destructive sync sequencing. It performs preflight checks, stale PATH checks, and git-backed backup workflows to ensure reliable synchronization after file moves or note edits.

Does this Obsidian MCP integration support CLI contexts for active-file and plugin tasks?

Yes, this Obsidian MCP integration supports CLI contexts. It routes active-file and plugin-driven tasks through the Obsidian CLI while using MCP for safe read, write, and search operations across your vault.

Why does my automated file move fail during Obsidian vault operations?

Automated file moves can fail if exact path confirmations or stale PATH checks detect discrepancies. The Skill enforces these constraints alongside unique patch matching to prevent unsafe operations and maintain vault structure integrity.

How do I search and organize Obsidian notes without breaking the vault structure?

You can search and organize notes safely by routing requests through the Skill's safe read, write, and search operations. It enforces exact path confirmations and YAML validation to ensure note moves and edits do not break the vault.