integration-calendly

What problem does it solve?

This Skill connects Calendly to a self-hosted Hermes agent when you need scheduling data and booking workflows to work headlessly on a remote VPS without exposing secrets or requiring manual server setup.

Core Features & Use Cases

• SSH-first setup: Verifies access to the VPS, checks Hermes availability, and performs all changes remotely and idempotently.
• Secure token handling: Stores a Calendly personal access token in the Hermes environment and protects it with strict file permissions.
• REST-based integration: Wires Calendly through the supported API path for users, event types, scheduled events, invitees, availability, and scheduling links.
• Safety and recovery: Provides dry-run preview, gateway reload guidance, live API smoke tests, and rollback logic for failed wiring attempts.
• Use case: A user wants their AI agent to read Calendly availability, inspect upcoming meetings, or generate booking links while keeping the integration on their own server.

Quick Start

Ask the agent to connect Calendly to your Hermes VPS by providing the SSH host details and a Calendly personal access token, then let it verify Hermes, store the secret, reload the gateway, and confirm the API connection.