obsidian-mcp

Automate Obsidian vault note reads, writes, searches, and metadata edits via MCP.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/ollieb89/orchestrator --skill obsidian-mcp
Or copy as Structured Prompt for Agentâ–¼
Please help me install this Agent Skill.
Skill: obsidian-mcp
Source: https://github.com/ollieb89/orchestrator/tree/main/.windsurf/skills/obsidian-mcp
Command: npx skills add https://github.com/ollieb89/orchestrator --skill obsidian-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Obsidian MCP enables safe, programmatic interactions with Obsidian vaults by exposing read, write, search, and metadata-management capabilities through a server-safe API surface. It protects vault integrity by enforcing safe paths and validating frontmatter before changes are applied.

Core Features & Use Cases

  • Atomic updates: Use patch_note to modify specific text without rewriting entire files.
  • Metadata management: Update frontmatter and manage tags to organize notes and support workflows.
  • Batch operations: Read multiple notes in a single call to reduce round-trips and consolidate research.
  • Note creation and search: Write new notes and search content or frontmatter to locate relevant information quickly.

Quick Start

Run a simple read_note operation to verify access to your vault.

Frequently Asked Questions about obsidian-mcp

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

FAQPage Schema
How do I automate Obsidian vault interactions programmatically?â–¼

Automate Obsidian vault interactions by using a server-safe API to read, write, search, and organize notes. This approach validates frontmatter and enforces safe paths to protect vault integrity during targeted edits and batch operations.

Can I update frontmatter and manage tags in Obsidian notes via API?â–¼

Yes, you can update frontmatter and manage tags via API. Dedicated metadata management capabilities allow you to programmatically organize notes and support workflows by modifying frontmatter fields and managing tags safely.

What is the best way to modify specific text within an Obsidian note without rewriting the whole file?â–¼

The best way to modify specific text is using atomic updates via a patch operation. This allows you to patch specific text sections in notes without rewriting entire files, ensuring safe and targeted edits.

How do I read multiple Obsidian notes in a single call to consolidate research?â–¼

Read multiple Obsidian notes in a single call by using batch read operations. This reduces round-trips and consolidates research by fetching multiple note contents simultaneously through the API.

Does Obsidian MCP work with collaborative vaults for batch note operations?â–¼

Yes, Obsidian MCP works with both personal and collaborative vaults. It enables batch note operations across note collections, supporting targeted edits and metadata management while enforcing safe paths to protect vault integrity.

How do I search Obsidian note content and frontmatter to locate information quickly?â–¼

Search Obsidian note content and frontmatter by using the search capabilities exposed via the API. This allows you to locate relevant information quickly by querying both the text content and the frontmatter metadata of notes.