How do I install the Obsidian skill?

Run npx skillmds@latest add diegosouzapw/obsidian in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian by diegosouzapw — Agent Skill

Name: Obsidian
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

Obsidian

Read, write, search, and manage Obsidian vault notes. Use when: (1) Reading/writing markdown notes, (2) Searching vault content, (3) Managing daily/periodic notes, (4) Tracking tasks or oncall incidents. Supports filesystem access and Local REST API.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Obsidian Vault Integration

Configuration

export OBSIDIAN_VAULT_PATH="/path/to/your/vault"
export OBSIDIAN_API_KEY="your-api-key-here"           # From: Obsidian Settings → Local REST API
export OBSIDIAN_DAILY_FORMAT="Journal/Daily/%Y-%m-%d.md"  # Optional
export OBSIDIAN_TODO_FILE="Inbox/Tasks.md"            # Optional

CLI Tools

Filesystem (obsidian.sh)

./scripts/obsidian.sh fs-read <path>            # Read note
./scripts/obsidian.sh fs-write <path> <content> # Write note
./scripts/obsidian.sh fs-list [dir]             # List .md files
./scripts/obsidian.sh fs-search <query>         # Grep search
./scripts/obsidian.sh fs-daily-append <content> # Append to daily note

Thought (Daily Notes)

thought "Great idea for the app"
thought "Meeting went well" meeting work

Todo Tracking

todo add "Review PR" work --due tomorrow --priority high
todo done 1                    # Complete by number
todo done "PR"                 # Complete by search
todo delete 2                  # Remove task
todo list                      # Show pending
todo list work                 # Filter by tag

See: references/todo.md

Oncall Tracking

oncall start                   # Start shift
oncall log "Alert fired" incident database
oncall resolve "Fixed it" database
oncall summary                 # View current shift
oncall end                     # End and archive

See: references/oncall.md

REST API (obsidian.sh)

./scripts/obsidian.sh status              # Check connection
./scripts/obsidian.sh read <path>         # Read via API
./scripts/obsidian.sh write <path> <content>
./scripts/obsidian.sh daily               # Get daily note
./scripts/obsidian.sh daily-append <content>
./scripts/obsidian.sh search <query>      # Simple search

See: references/api-reference.md

Quick Filesystem Access

# Read
cat "$OBSIDIAN_VAULT_PATH/folder/note.md"

# Write
cat > "$OBSIDIAN_VAULT_PATH/folder/note.md" << 'EOF'
# My Note
Content here
EOF

# Search
grep -r "term" "$OBSIDIAN_VAULT_PATH" --include="*.md"

Decision Guide

Need	Method
Fast read/write	Filesystem
Quick thoughts/notes	`thought` CLI
Task management	`todo` CLI
Oncall/incidents	`oncall` CLI
Search by frontmatter	REST API
Dataview queries	REST API
Execute commands	REST API
No Obsidian running	Filesystem

Reference Docs

API Reference - REST API endpoints and curl examples
Thought Reference - Quick notes to daily journal
Todo Reference - Task management with Obsidian Tasks format
Oncall Reference - Incident tracking and shift management

---name: obsidiandescription: Read, write, search, and manage Obsidian vault notes. Use when: (1) Reading/writing markdown notes, (2) Searching vault content, (3) Managing daily/periodic notes, (4) Tracking tasks or oncall incidents. Supports filesystem access and Local REST API.---# Obsidian Vault Integration## Configuration```bashexport OBSIDIAN_VAULT_PATH="/path/to/your/vault"export OBSIDIAN_API_KEY="your-api-key-here" # From: Obsidian Settings → Local REST APIexport OBSIDIAN_DAILY_FORMAT="Journal/Daily/%Y-%m-%d.md" # Optionalexport OBSIDIAN_TODO_FILE="Inbox/Tasks.md" # Optional```## CLI Tools### Filesystem (obsidian.sh)```bash./scripts/obsidian.sh fs-read <path> # Read note./scripts/obsidian.sh fs-write <path> <content> # Write note./scripts/obsidian.sh fs-list [dir] # List .md files./scripts/obsidian.sh fs-search <query> # Grep search./scripts/obsidian.sh fs-daily-append <content> # Append to daily note```### Thought (Daily Notes)```bashthought "Great idea for the app"thought "Meeting went well" meeting work```### Todo Tracking```bashtodo add "Review PR" work --due tomorrow --priority hightodo done 1 # Complete by numbertodo done "PR" # Complete by searchtodo delete 2 # Remove tasktodo list # Show pendingtodo list work # Filter by tag```See: [references/todo.md](references/todo.md)### Oncall Tracking```bashoncall start # Start shiftoncall log "Alert fired" incident databaseoncall resolve "Fixed it" databaseoncall summary # View current shiftoncall end # End and archive```See: [references/oncall.md](references/oncall.md)### REST API (obsidian.sh)```bash./scripts/obsidian.sh status # Check connection./scripts/obsidian.sh read <path> # Read via API./scripts/obsidian.sh write <path> <content>./scripts/obsidian.sh daily # Get daily note./scripts/obsidian.sh daily-append <content>./scripts/obsidian.sh search <query> # Simple search```See: [references/api-reference.md](references/api-reference.md)## Quick Filesystem Access```bash# Readcat "$OBSIDIAN_VAULT_PATH/folder/note.md"# Writecat > "$OBSIDIAN_VAULT_PATH/folder/note.md" << 'EOF'# My NoteContent hereEOF# Searchgrep -r "term" "$OBSIDIAN_VAULT_PATH" --include="*.md"```## Decision Guide| Need | Method || --------------------- | ------------- || Fast read/write | Filesystem || Quick thoughts/notes | `thought` CLI || Task management | `todo` CLI || Oncall/incidents | `oncall` CLI || Search by frontmatter | REST API || Dataview queries | REST API || Execute commands | REST API || No Obsidian running | Filesystem |## Reference Docs- [API Reference](references/api-reference.md) - REST API endpoints and curl examples- [Thought Reference](references/thought.md) - Quick notes to daily journal- [Todo Reference](references/todo.md) - Task management with Obsidian Tasks format- [Oncall Reference](references/oncall.md) - Incident tracking and shift management

Frequently asked questions