Obsidian CLI

Interact with Obsidian using the official CLI to read, search, create, and manage notes, daily notes, tasks, properties, and more. Use when the user wants to query or manipulate vault content via the obsidian command.

52 stars 10 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jykim/claude-obsidian-skills --skill obsidian-cli
Manual install
git clone --depth 1 https://github.com/jykim/claude-obsidian-skills.git /tmp/claude-obsidian-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-obsidian-skills/obsidian-cli ~/.claude/skills/obsidian-cli

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Obsidian CLI Skill

The official Obsidian command-line interface allows you to interact with your vault from the terminal — reading notes, searching, managing properties, handling tasks, and more.

## Prerequisites

Verify the CLI is installed and running:

```bash
obsidian --version
obsidian help
```

Requirements:
- **Obsidian v1.12+** (released late 2024)
- **Catalyst license or higher** (Obsidian Sync, Publish, or community support)
- **Obsidian must be running** — the CLI communicates via IPC with a live instance
- **macOS, Windows, or Linux** support

If not installed, download the latest Obsidian installer from https://obsidian.md/download

## Key Concepts

### IPC-Based Communication
The obsidian-cli works by connecting to a **running Obsidian instance** via inter-process communication (IPC). It does not manipulate files directly; all commands are executed through Obsidian's API, ensuring proper handling of plugins, sync, and vault structure.

### File vs Path Parameters
Two ways to target files:

- **`file=<name>`** — Resolves by name like wikilinks. Searches across folders to find the file. More flexible but slower.
  - Example: `obsidian read file="My Note"` (finds the file regardless of folder)
  - Best for: Quick access when you know the filename

- **`path=<path>`** — Exact path from vault root. No searching, just direct access.
  - Example: `obsidian read path="Journal/2026-02-28.md"` (exact path required)
Read the full skill on GitHub

Details

Skill name
obsidian-cli
Path
obsidian-cli/SKILL.md
License
MIT
Repo updated
23 September 2026

FAQ

What does the Obsidian CLI skill do?

Interact with Obsidian using the official CLI to read, search, create, and manage notes, daily notes, tasks, properties, and more. Use when the user wants to query or manipulate vault content via the obsidian command.

How do I install the Obsidian CLI skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jykim/claude-obsidian-skills --skill obsidian-cli. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Obsidian CLI popular?

It lives in jykim/claude-obsidian-skills, which has 52 GitHub stars and 10 forks.

Related skills

Ai4pkm Helper

52

jykim/claude-obsidian-skills

AI4PKM helper for orchestrator configuration, worker management, and CLI workflow integration.

Productivity & Notes10

Create Vlog Script

52

jykim/claude-obsidian-skills

Create narration-first personal vlog scripts and slide-based recording guides from rough spoken notes and a supplied media folder. Use for reflective video essays, travel or event vlogs, and video-editing briefs; do not use for producing the final edited video unless requested.

Images, Video & Audio10

Interactive Writing Assistant

52

jykim/claude-obsidian-skills

This skill provides comprehensive support for the writing process from ideation through revision. Use this skill when helping users write essays, articles, or creative pieces through interactive collaboration. The skill supports co-evolving outline and prose, voice-based input processing, multiple writing styles, and connection to the user's PKM system for enriched content.

Writing & Content10

Obsidian Links

52

jykim/claude-obsidian-skills

Format and validate Obsidian wiki links with proper filename, section, and folder conventions. Verify links exist before creation and fix broken links. Use when creating or checking wiki links in markdown files.

Productivity & Notes10

Obsidian Markdown Structure

52

jykim/claude-obsidian-skills

Validate and enforce markdown document structure including frontmatter positioning, heading hierarchy, and content organization. Use when creating or validating markdown files.

Productivity & Notes10

Weekly Project Digest

40

makenotion/cursor-notion-plugin

Produces evidence-based weekly project or team updates by comparing reporting periods, tasks, decisions, and blockers in Notion. Use for recurring status digests; use spec-to-implementation for requirement-level implementation tracking.

Productivity & NotesIn 1 list21

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.