obsidian-vault

Manage Obsidian vault notes via the Local REST API.

7|2|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/hancengiz/cc-obsidian-vault-api-skill --skill obsidian-vault-hancengiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault
Source: https://github.com/hancengiz/cc-obsidian-vault-api-skill/tree/main
Command: npx skills add https://github.com/hancengiz/cc-obsidian-vault-api-skill --skill obsidian-vault-hancengiz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, zip, and includes scripts (resource) components.

What problem does it solve?

This skill enables Claude to manage Obsidian vaults through the Local REST API, turning complex vault operations into natural-language interactions.

Core Features & Use Cases

  • Read, search, create, update, and delete vault notes with Obsidian formatting
  • Manage daily/periodic notes and run Dataview/JsonLogic queries
  • Execute Obsidian commands and open files in the UI to streamline workflows
  • Maintain vault integrity with safety guardrails and explicit confirmations for destructive actions

Quick Start

Begin by asking Claude to search your vault for notes about a topic, read a specific note, or create a new note in a folder. For example: "Read Projects/Overview.md" or "Create a note in Projects called 'Meeting Notes' with a summary."

Frequently Asked Questions about obsidian-vault

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

FAQPage Schema
How do I manage my Obsidian vault using natural language commands?

You can manage your Obsidian vault using natural language by connecting Claude to the Local REST API plugin. This setup enables reading, searching, creating, and updating notes through conversational commands instead of manual editing.

Can I run Dataview and JsonLogic queries on my Obsidian vault via API?

Yes, you can run Dataview and JsonLogic queries on your Obsidian vault via the Local REST API. The integration supports complex vault searches and data retrieval operations directly through natural language requests.

Do I need the Local REST API plugin to automate Obsidian daily notes?

Yes, the Local REST API plugin and a valid API key are required to automate Obsidian daily notes. This plugin provides the local endpoint necessary for creating, updating, and managing periodic notes safely.

What safety guardrails exist when updating or deleting Obsidian notes?

Safety guardrails for updating or deleting Obsidian notes include mandatory explicit confirmations for destructive actions. The system enforces strict rules and multi-source configuration checks to prevent accidental data loss during vault modifications.

How to perform surgical PATCH operations across Obsidian vault files?

Surgical PATCH operations across Obsidian vault files are executed via the Local REST API to update specific note sections. This allows precise content modifications without overwriting entire files, maintaining overall vault integrity.

Why use curl and zip for Obsidian vault management workflows?

Curl and zip are required dependencies for Obsidian vault management workflows to handle API requests and vault backups. Curl facilitates communication with the Local REST API, while zip enables vault archiving for safe operations.