obsidian-setup

Install and configure Obsidian vaults with Local REST API bridges and MCP server registration.

2|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill obsidian-setup-mbadali25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-setup
Source: https://github.com/mbadali25/useful-claude-add-ons/tree/main/plugin/obsidian-vault/skills/obsidian-setup
Command: npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill obsidian-setup-mbadali25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Obsidian with the Local REST API plugin and wiring it into Claude Code as MCP servers involves many failure-prone steps: resolving vault paths, installing Obsidian per-OS, enabling community plugins, reading API keys, avoiding port collisions, and registering one MCP server per vault. This Skill codifies that entire procedure so the bridge works end to end. ## Core Features & Use Cases - Vault discovery and diagnosis: Scan every vault on the machine via vault_ops.py scan and diagnose, including vaults the plugin config has never heard of. - Guided installation: OS-specific Obsidian install paths (winget, Homebrew, Flatpak, AppImage) plus the manual Local REST API community plugin prerequisite. - MCP registration and repair: Register one obsidian-<name> MCP server per vault against its HTTP port, fix port collisions, reload stale Obsidian windows, and re-register after key rotation. - Use Case: A user says "set up Obsidian" or reports that mcp__obsidian__* tools stopped working; the Skill walks through scan, plugin enablement, registration, config writing, and a final diagnose verification. ## Quick Start Ask the assistant to set up Obsidian and configure the vault bridge, or to diagnose why the obsidian MCP tools are not connecting.

Frequently Asked Questions about obsidian-setup

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

FAQPage Schema
How do I set up Obsidian with Claude Code MCP tools?

Install Obsidian, manually install the Local REST API community plugin inside Obsidian, then run vault_ops.py register --vault <name> --apply to register an obsidian-<name> MCP server per vault. Finish by writing ~/.claude/obsidian/config.json and verifying with the diagnose subcommand.

Why are my mcp__obsidian__* tools not working?

The most common causes are a stale Obsidian window (closing the window minimizes to tray instead of quitting), an API key that changed after registration, or two vaults colliding on the same port. Run vault_ops.py diagnose or the doctor command to get verdicts before attempting fixes.

Should the Obsidian MCP server use the HTTP or HTTPS port?

Always use the HTTP port (insecurePort in data.json). The HTTPS side uses a self-signed certificate that Claude Code's Node HTTP client rejects with DEPTH_ZERO_SELF_SIGNED_CERT, and a successful curl -k does not prove MCP will connect.

Can one MCP server connect to multiple Obsidian vaults?

No. Local REST API is a per-vault plugin instance on a per-vault port, live only while that vault is open. Register one server per vault named obsidian-<name> so tool names never collide.

Why does the Obsidian REST plugin disagree with its data.json file?

The plugin reads data.json only at load time, so any edit requires an Obsidian window reload to take effect. Use the repair reload command (Obsidian's app:reload) or fully quit from the tray and relaunch.