Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add terrylica/cc-skills --skill booking-notify -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/booking-notify/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/booking-notify/

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

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

From the same set79

The whole set →
bootstrap-monorepo bootstrap-monorepo scaffolds a polyglot monorepo using moon, proto, and Bun with a TypeScript control plane and strict boundary rules. CX Codex +1 126installs asciinema-converter asciinema-converter turns asciinema .cast recordings into clean .txt files for reading and search. It handles one file or a directory batch. CX Codex +1 126installs multi-agent-performance-profiling multi-agent-performance-profiling spawns five parallel profiling agents to investigate system layers: instrumentation, database config, client library, batch sizing, and synthesis. CX Codex +1 126installs clickhouse-cloud-management clickhouse-cloud-management manages ClickHouse Cloud database users and access permissions using SQL statements over HTTPS. CX Codex +1 126installs implement-plan-preflight implement-plan-preflight runs the ITP workflow preflight phase to generate MADR 4.0 architecture records, design specs, and linked diagrams. CX Codex +1 125installs issues-workflow issues-workflow puts plan, hierarchy and status into GitHub Issues: sub-issues under a parent, an issue linked to its branch and pull request, and a close on merge. CX Codex +1 124installs ml-failfast-validation ml-failfast-validation is a Claude Code skill that runs preflight checks for machine learning experiments, catching tensor, schema, and gradient errors before long training jobs. CX Codex +1 124installs pr-gfm-validator pr-gfm-validator turns relative markdown links in a pull request body into absolute blob URLs pinned to your feature branch, so reviewers stop landing on 404s. CX Codex +1 123installs

More in the catalog

Project sponsors

Companies that keep this analytics open