booking-notify — Claude Code skill: Cal.com booking alerts
booking-notify sends notifications for new bookings, cancellations and reschedules via Telegram and Pushover. 6-hour polling sync, real-time webhook for urgent events.
MIT 125 installs ★ 3 updated 2026-10-25
npx skills add terrylica/cc-skills --skill booking-notify -a claude-codeWhat booking-notify does
The skill polls Cal.com API every 6 hours via launchd and sends changes to Telegram as HTML-formatted messages with interactive commands. For urgent events — new booking or reschedule — it pushes a Pushover notification through a Cloud Run webhook relay with the 'dune' sound and emergency priority, requiring acknowledgement.
Three preflight checks run before each sync: presence of the sync.ts script, environment variables (CALCOM_OP_UUID, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID), and the built calcom-cli binary. If the binary is missing, the script builds it via bun run build. Pushover is optional: without tokens, only the Telegram channel operates.
The script compares current state against the last known state from a file, detects new entries, cancellations and reschedules, and updates the file after each cycle. A circuit breaker prevents cascade failures on API errors.
What it helps with
- receive booking notifications across two channels
- detect cancellations and reschedules in Cal.com
- send emergency push notification with acknowledgement via Pushover
- sync booking state every 6 hours
Example prompts for the agent
- Set up booking notification sync using
booking-notify - Check environment variables for Telegram and Pushover
- Run manual booking sync from Cal.com
How to install booking-notify
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a claude-code2Manually: put the files in place
~/.claude/skills/booking-notify/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/booking-notify/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a codex2Manually: put the files in place
.agents/skills/booking-notify/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a cursor2Manually: put the files in place
.cursor/skills/booking-notify/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/calcom-commander/skills/booking-notify2Manually: put the files in place
.github/skills/booking-notify/SKILL.md1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a gemini-cli2Platform CLI
gemini skills install https://github.com/terrylica/cc-skills --path plugins/calcom-commander/skills/booking-notifyManually: put the files in place
.devin/skills/booking-notify/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about booking-notify
How to install booking-notify in Claude Code?
Run npx skills add terrylica/cc-skills --skill booking-notify -a claude-code, then open ~/.claude/skills/booking-notify/SKILL.md to configure environment variables.
What does booking-notify do?
The skill syncs bookings from Cal.com every 6 hours and sends notifications for new entries, cancellations and reschedules to Telegram. If Pushover is configured, it sends urgent push notifications in real time via webhook.
What is required for the Pushover channel?
Export PUSHOVER_APP_TOKEN, PUSHOVER_USER_KEY and deploy the webhook relay on Cloud Run. Instructions are in pushover-setup.md and webhook-relay.md. Without Pushover, the skill operates via Telegram only.
Source text
SKILL.md · MIT
---
name: booking-notify
description: Dual-channel booking notifications via Telegram + Pushover. Scheduled sync, webhook relay, emergency alerts with custom sounds.
allowed-tools: Read, Bash, Grep, Glob
---
# Booking Notifications (Dual-Channel)
Automated booking notifications via two channels:
| Channel | Delivery | Format | Use Case |
| -------- | --------- | ---------- | ------------------------------------------ |
| Telegram | Scheduled | HTML | Interactive commands, daily digest, search |
| Pushover | Real-time | Plain text | Emergency alerts with custom sound (dune) |
> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
## Mandatory Preflight
### Step 1: Check Sync Script Exists
```bash
ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/sync.ts" 2>/dev/null || echo "SCRIPT_NOT_FOUND"
```
### Step 2: Verify Environment (Required)
```bash
echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
echo "TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN:+SET}"
echo "TELEGRAM_CHAT_ID: ${TELEGRAM_CHAT_ID:-NOT_SET}"
echo "HAIKU_MODEL: ${HAIKU_MODEL:-NOT_SET}"
```
**All must be SET.** If any are NOT_SET, run the setup command first.
### Step 3: Verify Pushover (Optional)
```bash
echo "PUSHOVER_APP_TOKEN: ${PUSHOVER_APP_TOKEN:+SET}"
echo "PUSHOVER_USER_KEY: ${PUSHOVER_USER_KEY:+SET}"
echo "PUSHOVER_SOUND: ${PUSHOVER_SOUND:-dune}"
echo "WEBHOOK_RELAY_URL: ${WEBHOOK_RELAY_URL:-NOT_SET}"
```
**If NOT_SET**: Pushover is optional. Telegram-only operation still works. To enable, see [pushover-setup.md](./references/pushover-setup.md).
### Step 4: Verify Cal.com CLI Binary
```bash
ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom" 2>/dev/null || echo "BINARY_NOT_FOUND"
```
**If BINARY_NOT_FOUND**: Build it:
```bash
cd "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli" && bun install && bun run build
```
## Notification Channels
### Telegram (Scheduled Sync)
6h polling via launchd. Sends HTML-formatted messages for:
| Category | Examples |
| ------------ | ------------------------------------------------ |
| NEW BOOKING | New interview scheduled, new consultation booked |
| CANCELLATION | Booking cancelled by attendee, host cancelled |
| UPCOMING | Booking starting in 1 hour, today's schedule |
| RESCHEDULED | Booking moved to new time, date changed |
### Pushover (Real-Time Webhook)
Instant notifications via Cloud Run webhook relay:
| Event | Priority | Sound | Must Acknowledge? |
| ----------- | ------------- | ----- | ----------------- |
| New booking | 2 (Emergency) | dune | Yes |
| Rescheduled | 2 (Emergency) | dune | Yes |
| Cancelled | 0 (Normal) | dune | No |
### Webhook Relay
The webhook relay is a lightweight Cloud Run service that bridges Cal.com webhooks to Pushover. See [webhook-relay.md](./references/webhook-relay.md) for deployment.
## Running Manually
```bash
cd ~/gh/<org>/<automation-repo> && bun run "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/sync.ts"
```
## Sync Behavior
1. Fetches bookings from Cal.com API (last 6h window)
2. Compares against last-known state (file-based)
3. Detects new bookings, cancellations, and reschedules
4. Sends Telegram notification (HTML) for each change
5. Sends Pushover notification (plain text) if credentials configured
6. Updates state file for next sync cycle
7. Circuit breaker prevents cascade failures on API errors
## Environment Configuration (Agnostic Wiring)
The scripts read plain environment variables. For the launchd daemons put them in `~/gh/<org>/<automation-repo>/.env.launchd` (sourced by the launcher scripts); for interactive use export them in your shell:
```bash
# Required (Telegram)
export CALCOM_OP_UUID='<1password-uuid>'
export TELEGRAM_BOT_TOKEN='<bot-token>'
export TELEGRAM_CHAT_ID='<chat-id>'
# Optional (Pushover dual-channel)
export PUSHOVER_APP_TOKEN='<pushover-app-token>'
export PUSHOVER_USER_KEY='<pushover-user-key>'
export PUSHOVER_SOUND='dune'
export WEBHOOK_RELAY_URL='https://calcom-pushover-webhook-XXXXX.us-central1.run.app/'
```
## References
- [notification-templates.md](./references/notification-templates.md) — Dual-channel message templates
- [pushover-setup.md](./references/pushover-setup.md) — Pushover credential setup guide
- [webhook-relay.md](./references/webhook-relay.md) — Webhook relay deployment + management
- [sync-config.md](./references/sync-config.md) — Sync interval and state management
## Post-Change Checklist
- [ ] YAML frontmatter valid (no colons in description)
- [ ] Trigger keywords current
- [ ] Path patterns use $HOME not hardcoded paths
- [ ] Pushover graceful degradation verified (works without Pushover creds)
## Post-Execution Reflection
After this skill completes, reflect before closing the task:
0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.
Do NOT defer. The next invocation inherits whatever you leave behind.
© terrylica · MIT · terrylica/cc-skills