skills.rest
Mateus2411
Mateus2411COMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill obsidian-mateus2411
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Education & Research Skills→
Brilly-BohyunBrilly-Bohyun

obsidian

Read, search, create, and edit markdown notes in an Obsidian vault.

Community
Intermediate
jasnyjasny

gitbook

Edit GitBook documentation using markdown syntax, frontmatter, and Git Sync.

Community
Intermediate
morigemini6668-uxmorigemini6668-ux

Obsidian Search

Search Obsidian vault notes using keywords, frontmatter tags, and wikilinks.

Community
Intermediate
SethyPagnaSethyPagna

obsidian

Manage markdown notes in an Obsidian vault with filesystem-first workflows.

Community
Intermediate