obsidian

Read, search, create, and edit notes in Obsidian vaults via programmatic file operations.

Updated May 2, 2026
One-click install
npx skills add https://github.com/AlvaroBiano/hermes-agent --skill obsidian-alvarobiano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/AlvaroBiano/hermes-agent/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/AlvaroBiano/hermes-agent --skill obsidian-alvarobiano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Programmatic access to an Obsidian vault for reading, listing, searching, creating, and editing notes, reducing manual file operations and enabling automated workflows.

Core Features & Use Cases

  • Read notes by path to fetch content and metadata.
  • List notes across the vault and locate notes by pattern or content.
  • Search note contents and filenames to surface relevant information quickly.
  • Create new notes and append content, including wikilinks to connect related ideas.
  • Append to existing notes while preserving structure and links.
  • Resolve the vault path using the OBSIDIAN_VAULT_PATH environment variable, with a fallback to standard locations.

Quick Start

Set the OBSIDIAN_VAULT_PATH environment variable to your vault path and call the note tools to read, list, search, create, or append notes.

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 notes programmatically?

To search and read Obsidian notes programmatically, use file operations to fetch content by path or search filenames and text across the vault. This enables automated workflows without manual file browsing.

How do I create and append content to Obsidian vault notes?

Create and append content to Obsidian vault notes by using native file operations to write new files or add text to existing ones. This preserves the note structure and supports adding wikilinks.

Do I need an environment variable to access my Obsidian vault path?

Yes, you need the OBSIDIAN_VAULT_PATH environment variable to define your Obsidian vault path. If it is not set, the system falls back to the ~/Documents/Obsidian Vault directory.

Can I use Obsidian vault file tools on Linux, macOS, and Windows?

Yes, you can use these Obsidian vault file tools on Linux, macOS, and Windows. They rely on native file operations over shell expansions to avoid cross-platform path resolution issues.

How do I link related Obsidian notes with wikilinks programmatically?

Link related Obsidian notes programmatically by appending wikilinks to existing or newly created notes via file operations. This connects related ideas directly within the vault structure.

What is the best way to list notes in an Obsidian vault by pattern?

The best way to list notes in an Obsidian vault by pattern is using programmatic file tools to locate notes across the directory. This surfaces matching files quickly without opening the Obsidian app.