obsidian

Manage Obsidian vault notes, tags, and frontmatter programmatically.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/Kuass/kiro-gateway-plus --skill obsidian-kuass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/Kuass/kiro-gateway-plus/tree/main/.opencode/skill/obsidian
Command: npx skills add https://github.com/Kuass/kiro-gateway-plus --skill obsidian-kuass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mauricio.wolff/mcp-obsidian, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a robust interface for interacting with your Obsidian vault, allowing you to read, write, search, and manage notes and tags programmatically without leaving your current environment.

Core Features & Use Cases

  • Note Management: Create, read, update, delete, and move notes within your vault.
  • Content & Frontmatter Operations: Extract and manipulate note content and YAML frontmatter.
  • Search & Tagging: Efficiently search notes by content or frontmatter and manage tags.
  • Vault Operations: List directory contents and perform safe deletions with confirmation.
  • Use Case: Automatically append meeting notes to your daily log, search for all notes tagged with "project-X", or update the frontmatter of a research paper with new keywords.

Quick Start

Use the obsidian skill to write a new note with the path 'notes/new-idea.md' and content '# My New Idea'.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I manage Obsidian vault notes programmatically?

You can manage Obsidian vault notes programmatically by using this Skill to read, write, update, delete, and move notes. It enables direct content manipulation and search operations without leaving your current environment.

Can I search Obsidian vault content and frontmatter programmatically?

You can search Obsidian vault content and frontmatter programmatically using this Skill to query across note text and YAML metadata. It supports finding notes by content and managing tags.

How do I update YAML frontmatter in Obsidian notes automatically?

Updating YAML frontmatter in Obsidian notes automatically is possible through this Skill's content and frontmatter operations. It allows you to extract and manipulate YAML metadata directly within your vault files.

Do I need a configured environment variable to interact with an Obsidian vault?

Yes, you need a configured OBSIDIAN_VAULT_PATH environment variable or an opencode.json configuration for the mcp-obsidian server. This setup is required to enable programmatic interaction with your vault.

What is the best way to append meeting notes to a daily log in Obsidian?

The best way to append meeting notes to a daily log in Obsidian is using this Skill's note management features to write or update content. It supports automatically adding new content to existing notes within your vault.

Are there limitations when moving or deleting notes in an Obsidian vault?

When moving or deleting notes in an Obsidian vault, this Skill performs safe deletions requiring confirmation to prevent data loss. It also supports listing directory contents to help navigate vault structure during operations.