Wraps the Obsidian CLI (built into Obsidian 1.12+) so Claude can read, write, and search your vault notes without installing an MCP server or REST API plugin. Part of the claude-obsidian v1.7+ transport layer. The skill auto-detects whether the CLI binary is available and falls back to direct filesystem operations if not. You get cleaner auth (no TLS bypass), lower latency than HTTP, and better error messages when things break. The author recommends preferring kepano/obsidian-skills if available since Steph Ango's canonical CLI skill is the authoritative reference. Desktop only, so mobile workflows still need filesystem writes.

skills.sh installs
317
GitHub stars
16.3K
last updated
May 28, 2026

Install

$ npx -y skills add agricidaniel/claude-obsidian --skill wiki-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

Obsidian CLI read transport

Use this skill only to detect transport and read or search a selected vault. The official executable is obsidian; binary presence alone does not prove it is usable.

Resolve the installed product root from this skill's own location, not from the vault or current working directory:

PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
DETECT_TRANSPORT="$PRODUCT_ROOT/scripts/detect-transport.sh"
test -f "$DETECT_TRANSPORT"

Every ../wiki/references/ link in this file resolves the same way, relative to this skill's own directory under $PRODUCT_ROOT, never relative to the selected vault's wiki/ directory.

Detect safely

Probe without persisting host state:

bash "$DETECT_TRANSPORT" --peek --vault "$VAULT"

Trust available.cli.usable, not merely present or exit status. A supported CLI can still be unavailable because the Obsidian app is not running, command line access is disabled, or its response is an error. Use filesystem reads as the portable fallback.

Persist a refreshed .vault-meta/transport.json only when the user or setup workflow asks for a transport snapshot:

Sponsors

Details

Repository
github.com/agricidaniel/claude-obsidian
Categories
Backend & APIs, Documentation, AI & Agent Building, CLI & Terminal, Office & Documents
License
MIT
First seen
Jun 11, 2026

More from agricidaniel/claude-obsidian

All 15
1secondsky avatarcloudflare-workers-migrationsecondsky/claude-skillsMigrate to Cloudflare Workers from AWS Lambda, Vercel, Express, and Node.js. Use when porting existing applications to the edge, adapting serverless functions, 310skills.sh installs
2patricio0312rev avatarcurl-command-generatorpatricio0312rev/skillsGenerates ready-to-run cURL commands from Express, Next.js, Fastify, or other API routes. Creates copy-paste commands with proper headers, authentication, and r308skills.sh installs
3patricio0312rev avatarpage-layout-builderpatricio0312rev/skillsGenerates complete page layouts and shells for common patterns (dashboard, authentication, settings, CRUD pages) with consistent navigation, layout components, 308skills.sh installs
4asif2bd avatarjarvis-mission-controlasif2bd/jarvis-mission-control-openclawSet up JARVIS Mission Control v2.1.0 — a free, open-source AI agent coordination hub by MissionDeck.ai. Kanban board, real-time WebSocket updates, team chat, sc305skills.sh installs
5pproenca avatarrestful-hateoaspproenca/dot-skillsRESTful API design guidelines following the Richardson Maturity Model through to Level 3 (HATEOAS) for Ruby on Rails. This skill should be used when designing, 298skills.sh installs
6jup-ag avatarjupiter-swap-migrationjup-ag/agent-skillsMigration guide from Jupiter Metis (v1) or Ultra to Swap API v2. Use when migrating existing Jupiter swap integrations, updating base URLs, or transitioning fro297skills.sh installs