integration-obsidian

Connect an Obsidian vault to a self-hosted Hermes agent via SSH.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-obsidian
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-obsidian
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects an Obsidian vault to a self-hosted Hermes agent so the agent can read, write, and organize notes without manual copy-paste or brittle one-off workflows.

Core Features & Use Cases

  • SSH-first vault integration: Use the vault as files on the VPS for reliable, always-on note access.
  • Tunneled desktop API access: Reach the Obsidian Local REST API through Tailscale or Cloudflare Tunnel when the laptop app is open.
  • MCP wrapper support: Wire the vault through mcp-obsidian when you need stdio-based MCP integration.
  • Idempotent, rollback-safe setup: Validate connectivity first, write configuration only after checks pass, and recover cleanly if anything fails.
  • Use Case: A knowledge worker wants an AI agent to create daily notes, update project pages, or sync research summaries into Obsidian from a remote VPS.

Quick Start

Use the integration-obsidian skill to connect my Obsidian vault to my Hermes agent using the safest available path for my setup.

Frequently Asked Questions about integration-obsidian

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

FAQPage Schema
How do I connect my Obsidian vault to a self-hosted AI agent?

You can connect an Obsidian vault to a self-hosted Hermes agent using SSH-first vault-file syncing, tunneled Local REST API access, or mcp-obsidian wiring. This enables the agent to read, write, and organize notes directly.

What is the safest way to sync Obsidian vault files to a remote VPS?

The safest way to sync Obsidian vault files to a remote VPS is using an SSH-first integration path. The setup validates connectivity first, writes configuration only after checks pass, and recovers cleanly if anything fails.

Can I access the Obsidian Local REST API through a tunnel when my laptop app is open?

Yes, you can reach the Obsidian Local REST API through Tailscale or Cloudflare Tunnel when the desktop app is open. This tunneled desktop API access enables remote note creation, editing, and retrieval.

Does mcp-obsidian support stdio-based MCP integration for note retrieval?

Yes, mcp-obsidian wiring supports stdio-based MCP integration. This allows you to wire the vault through mcp-obsidian for reliable note creation, editing, and retrieval from a self-hosted agent.

Do I need SSH access to set up an Obsidian vault integration with a Hermes agent?

You need verified SSH access to use the SSH-first vault integration path. Alternatively, you can choose tunneled Local REST API access or mcp-obsidian wiring paths, depending on your environment and sync requirements.

What happens if the Obsidian vault connection fails during setup?

If the Obsidian vault connection fails during setup, the idempotent rollback-safe handling recovers cleanly. It validates connectivity first and writes configuration only after checks pass to prevent broken states.