Skip to content
← Public packages

@kentcdodds/cal-com

Cal.com helpers for booking pages, event types, slots, and webhooks.

FollowFork

IntegrationsTopics: cal-com, calendar, scheduling, bookings, webhooks, openapi

Version
1.0.0
License
MIT
Published
October 16, 2026
Pinned commit
5541cd6
Rating
No ratings yet
Forks
0
Adaptation effort
—

README

Agent docs

@kentcdodds/cal-com

Intent

Cal.com scheduling helpers for booking pages, event types, availability slots, bookings, and webhooks. The REST layer is a thin OpenAPI-scaffolded client against Cal.com API v2, with domain helpers that return parsed/unwrapped JSON and a small booking-page summary.

Use google-products/calendar for direct Google Calendar event CRUD instead of Cal.com booking flows.

What it does

  • Read profile, bookings, event types, available slots, and webhooks
  • Summarize booking pages (username + event-type booking URLs)
  • Create, cancel, or reschedule bookings when you explicitly request it
  • Register Cal.com webhooks for automation
  • Escape-hatch request helper for uncommon Cal.com API v2 paths

Prerequisites / setup

  1. Create a Cal.com API key in the Cal.com developer settings.
  2. Save it in Kody as user secret cal-com-api-key (do not paste the key value in chat).
  3. Approve host api.cal.com if prompted, and approve this package to use cal-com-api-key.
  4. Agents: see AGENTS.md for import paths and smoke checks.

Done when

  • cal-com-api-key is saved; api.cal.com and package secret access are approved
  • Read-only smoke test returns profile and event-type catalog checks
  • Booking / webhook mutations are only run after you confirm the target event, attendee, and times
Report this listing

Log in to report this listing.