hermes-nextcloud: skill pack for Hermes Agent

Hermes Agent skill for managing Nextcloud files, notes, calendar events, tasks and contacts

What hermes-nextcloud does

The skill is a Python CLI, nextcloud_api.py, driven by Hermes through its SKILL.md manifest. Files can be listed, uploaded, downloaded, moved and deleted over WebDAV. Notes are created, listed, edited and deleted through the Nextcloud Notes API. Calendar events and tasks use CalDAV, with times handled in a configured timezone, and contacts can be browsed, searched and exported as vCard. A check command verifies the setup.

Setup is guided by scripts/setup.py, which asks for the Nextcloud URL, username and an app password, validates them, and saves them to ~/.hermes/nextcloud.env with mode 0600. Only app passwords are accepted, so access can be revoked from Nextcloud without touching the main login. Credentials can also be given as NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_TOKEN and an optional NEXTCLOUD_TIMEZONE that defaults to UTC. The skill talks over HTTPS only and needs no plugins or external services.

Key features

File upload, download, list, move and delete over WebDAV
Notes create, list, edit and delete through the Nextcloud Notes app
Calendar events and task items through CalDAV with a configurable timezone
Contact browsing, search and vCard export
Guided setup that saves an app password in a mode 0600 file
A check command to verify the connection

When to use it

Asking Hermes to add a meeting to your Nextcloud calendar
Saving conversation summaries as Nextcloud notes
Uploading or fetching a document on a home server without opening a browser
Looking up a contact card from a chat

Who it is for: Hermes Agent users who run their own Nextcloud on a VPS or home server.

How it fits with Hermes Agent

It is a skill built for Hermes Agent, installed under ~/.hermes/skills/productivity and loaded through its SKILL.md manifest.

How to install hermes-nextcloud

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

cd ~/.hermes/skills/productivity
git clone https://github.com/adnw-vinc/hermes-nextcloud.git nextcloud
python3 ~/.hermes/skills/productivity/nextcloud/scripts/setup.py

Requirements: A running Nextcloud instance, a Nextcloud app password, Python 3.8 or newer and Hermes Agent; the notes commands need the Notes app

FAQ

What is hermes-nextcloud?

hermes-nextcloud is a skill that connects Hermes Agent to a self-hosted Nextcloud. It wraps WebDAV, the Notes API, CalDAV and CardDAV so the agent can manage files, notes, events, tasks and contacts.

What do I need to run hermes-nextcloud?

You need a running Nextcloud instance, an app password created under Settings, Security, App passwords, Python 3.8 or newer and Hermes Agent. The notes commands also require the Notes app on your Nextcloud.

Is hermes-nextcloud free and open source?

Yes. The repository is MIT licensed.