obsidian

Read, search, create, and edit Obsidian vault notes via MCP or filesystem.

Updated May 10, 2026

Search Tags:#note-taking #vault search #obsidian #frontmatter #mcp integration #wikilinks #filesystem editing

Ready to run

npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill obsidian-mateus2411

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/Mateus2411/Hermes-PersonalBot/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill obsidian-mateus2411

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you read, search, create, and edit notes in an Obsidian vault reliably, even when you’re working with different runtime environments.

Core Features & Use Cases

MCP-first note operations: Use Obsidian MCP tools (when available) to read, search, write, patch, list, manage frontmatter/tags, move, and delete notes against a git-synced vault.
Filesystem fallback mode: When MCP tools are not available, operate directly on a resolved vault path using file-based tools for reading, searching, writing, patching, and safely updating content.
Vault path discovery and safety: Resolve vault location from OBSIDIAN_VAULT_PATH (or a documented fallback), avoid unresolved variables in file-tool calls, and require explicit confirmation for destructive actions.

Quick Start

Ask your assistant to “search my Obsidian vault for notes about ‘quantum mechanics’ and show the top 5 matches.”

Frequently Asked Questions about obsidian

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

FAQPage Schema

How do I search and read Obsidian vault notes using an AI assistant?▼

You can search and read Obsidian vault notes by using MCP-driven tools to query content and retrieve matching files. The Skill resolves your vault path and returns the top matches for your search query.

Can I edit frontmatter and tags in my Obsidian vault programmatically?▼

Yes, you can edit frontmatter and tags in your Obsidian vault programmatically. The Skill supports frontmatter and tag operations through both MCP tools and direct filesystem patching when MCP is unavailable.

Does Obsidian MCP integration work without a local filesystem?▼

Obsidian MCP integration works on remote platforms like Render and Telegram by using relative paths. When MCP tools are unavailable, a filesystem fallback mode operates directly on a resolved local vault path.

What is the best way to safely delete or move notes in an Obsidian vault?▼

The best way to safely delete or move notes is through built-in guardrails that require explicit confirmation. The Skill enforces these safe guardrails for destructive actions like delete and move to prevent data loss.

How do I resolve an unresolved OBSIDIAN_VAULT_PATH variable for vault editing?▼

To resolve an unresolved OBSIDIAN_VAULT_PATH variable, configure it with a valid directory path or use the documented fallback. The Skill requires a resolved vault path to avoid unresolved variables in filesystem tool calls.

Why does my vault search return no results when querying wikilinks?▼

Vault search may return no results for wikilinks if the vault path is unresolved or the search query does not match existing content. Ensure your OBSIDIAN_VAULT_PATH is valid and the target notes exist before searching.