Pp Cal Com

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/cal-com/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Cal.com — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the cal-com-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install cal-com --cli-only

2. Verify: cal-com-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/productivity/cal-com/cmd/cal-com-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for cal-com-pp-cli whenever an agent needs to read or mutate a Cal.com calendar without burning context on the multi-call dance the API requires for booking and rescheduling. The local store makes 'what's on my calendar', 'when am I free', 'who is overloaded', and 'where are my conflicts' near-instant offline answers. The composed book and reschedule next commands are the right tools for transactional bookings; the endpoint-mirror coverage is there for everything else.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Composed booking flows

• book — Schedule an attendee onto one of your event types in a single composed call — slot check, optional reservation, create, optional confirm.

  For the host scripting an attendee onto their calendar (admin onboarding, recruiter pre-fill, test fixtures). For the normal flow where the attendee picks their own time, share a URL from link list instead.

  cal-com-pp-cli book --event-type-id 96531 --start 2026-05-06T17:00:00Z --attendee-name Guest --attendee-email guest@example.com --dry-run

• slots find — Find first available slots across multiple event-type IDs in one call, ranked by start time.

  Use this when you don't know which event type fits — let the caller pick from a ranked merged list.

  cal-com-pp-cli slots find --event-type-ids 96531 --start tomorrow --end "tomorrow 23:59" --json

• reschedule next — Move an existing booking to the next available slot for the same event type, after a cutoff.

  Use this for last-minute bumps — one command instead of three, with dry-run safety.

  cal-com-pp-cli reschedule next --uid <booking-uid> --after tomorrow --dry-run

Local state that compounds

• agenda — Upcoming bookings in a window — today, this week, or any duration — read from the local store.

  Use this whenever an agent needs 'what's on my calendar'; single command across any time window.

  cal-com-pp-cli agenda --window today --json --select id,start,title,attendees

• analytics no-show — No-show, cancellation, volume, and density metrics over a window. Sister subcommands under analytics: bookings (volume), cancellations, no-show, density. --by accepts event-type, attendee, or weekday on the rate commands; analytics density --unit hour adds hourly heatmaps.

  Use this for capacity planning, no-show trend analysis, or attendee follow-up — answers no single API call provides.

  cal-com-pp-cli analytics no-show --window 90d --by attendee --json

• conflicts — Detects overlapping bookings within a time window — pairs whose time ranges intersect get reported. Reads the local store, no API call.

  Run before sending confirmations or after a bulk reschedule — surfaces double-bookings the API silently allows.

  cal-com-pp-cli conflicts --window 7d --json

• gaps — Finds open windows in your schedule that are available but unbooked, filtered by minimum block size.

  Use this for capacity planning — answers 'when can I take a meeting' rather than 'what's on my plate'.

  cal-com-pp-cli gaps --window 7d --min-minutes 60 --json

• workload — Booking distribution across team members over a window — surfaces overloaded vs underutilized hosts.

  Use this for round-robin tuning or to spot host burnout before it shows up as no-shows.

  cal-com-pp-cli workload --team-id 42 --window 30d --json

• event-types stale — Event types with zero bookings in the last N days — candidates for removal.

  Use this for quarterly cleanup — keeps your bookable surface from drifting.

  cal-com-pp-cli event-types stale --days 90 --json

Host control surface

• link create — Create a new bookable link (event type) on your Cal.com account; prints the cal.com/<your-username>/<slug> URL ready to share.

  The host's primary creative act. Bookable links are how attendees book time; this is the command to make one.

  cal-com-pp-cli link create --slug 30min --length 30 --title "30 Min Meeting"

• link list — List every bookable link you own with the full URL pre-rendered for copy-share.

  Use this to see what links you have and grab their URLs without hand-composing cal.com/<user>/<slug>.

  cal-com-pp-cli link list --json

• ooo set — Mark yourself out-of-office for a date range so Cal.com excludes the period from slot search.

  Going on vacation? Sick? Run this once and stop getting booked. Optional --redirect-to-user forwards bookings to a teammate (round-robin only).

  cal-com-pp-cli ooo set --start 2026-05-12 --end 2026-05-18 --reason vacation --notes "Hawaii trip"

• ooo list — List your active and upcoming OOO entries.

  cal-com-pp-cli ooo list --json

Agent-native plumbing

• webhooks coverage — Audits registered webhook triggers against the canonical set and reports lifecycle events with no subscriber.

  Run this whenever you add a new automation — surfaces missed triggers like BOOKING_NO_SHOW_UPDATED before they bite.

  cal-com-pp-cli webhooks coverage --json

Command Reference

api-keys — Manage api keys

• cal-com-pp-cli api-keys — Generate a new API key and delete the current one. Provide API key to refresh as a Bearer token in the Authorization...

bookings — Manage bookings

• cal-com-pp-cli bookings create — POST /v2/bookings is used to create regular bookings, recurring bookings and instant bookings. The request bodies...
• cal-com-pp-cli bookings get — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli bookings get-bookinguid — :bookingUid can be 1. uid of a normal booking 2. uid of one of the recurring booking recurrences 3. uid of...
• cal-com-pp-cli bookings get-by-seat-uid — Get a seated booking by its seat reference UID. This is useful when you have a seatUid from a seated booking and...

cal-com-auth — Manage cal com auth

• cal-com-pp-cli cal-com-auth — RFC 6749-compliant token endpoint. Pass client_id in the request body (Section 2.3.1). Use grant_type...

cal-com-auth-2 — Manage cal com auth 2

• cal-com-pp-cli cal-com-auth-2 <clientId> — Returns the OAuth2 client information for the given client ID

calendars — Manage calendars

• cal-com-pp-cli calendars check-ics-feed — If accessed using an OAuth access token, the APPS_READ scope is required.
• cal-com-pp-cli calendars create-ics-feed — If accessed using an OAuth access token, the APPS_WRITE scope is required.
• cal-com-pp-cli calendars get — If accessed using an OAuth access token, the APPS_READ scope is required.
• cal-com-pp-cli calendars get-busy-times — Get busy times from a calendar. Example request URL is `https://api.cal.com/v2/calendars/busy-times?timeZone=Europe%2...

conferencing — Manage conferencing

• cal-com-pp-cli conferencing get-default — If accessed using an OAuth access token, the APPS_READ scope is required.
• cal-com-pp-cli conferencing list-installed-apps — If accessed using an OAuth access token, the APPS_READ scope is required.

credits — Manage credits

• cal-com-pp-cli credits charge — Charge credits for a completed AI agent interaction. Uses externalRef for idempotency to prevent double-charging.
• cal-com-pp-cli credits get-available — Check if the authenticated user (or their org/team) has available credits and return the current balance.

destination-calendars — Manage destination calendars

• cal-com-pp-cli destination-calendars — If accessed using an OAuth access token, the APPS_WRITE scope is required.

event-types — Manage event types

• cal-com-pp-cli event-types create — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli event-types delete — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli event-types get — Hidden event types are returned only if authentication is provided and it belongs to the event type owner. Use the...
• cal-com-pp-cli event-types get-by-id — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli event-types update — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...

me — Manage me

• cal-com-pp-cli me clear-my-booking-limits — Removes all of the authenticated user's global booking limits. Only available to organization members — non-org...
• cal-com-pp-cli me get — If accessed using an OAuth access token, the PROFILE_READ scope is required.
• cal-com-pp-cli me get-my-booking-limits — Returns the authenticated user's global booking limits. Unset bounds are returned as null. Only available to...
• cal-com-pp-cli me update — Updates the authenticated user's profile. Email changes require verification and the primary email stays unchanged...
• cal-com-pp-cli me update-my-booking-limits — Partially updates the authenticated user's global booking limits. Only fields present in the request body are...
• cal-com-pp-cli me user-ooocontroller-create-my-ooo — If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.
• cal-com-pp-cli me user-ooocontroller-delete-my-ooo — If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.
• cal-com-pp-cli me user-ooocontroller-get-my-ooo — If accessed using an OAuth access token, the SCHEDULE_READ scope is required.
• cal-com-pp-cli me user-ooocontroller-update-my-ooo — If accessed using an OAuth access token, the SCHEDULE_WRITE scope is required.

notifications — Manage notifications

• cal-com-pp-cli notifications subscriptions-register — Register an app push subscription
• cal-com-pp-cli notifications subscriptions-remove — Remove an app push subscription

oauth — Manage oauth

oauth-clients — Manage oauth clients

• cal-com-pp-cli oauth-clients create — <Warning>These endpoints are deprecated and will be removed in the future.</Warning>
• cal-com-pp-cli oauth-clients delete — <Warning>These endpoints are deprecated and will be removed in the future.</Warning>
• cal-com-pp-cli oauth-clients get — <Warning>These endpoints are deprecated and will be removed in the future.</Warning>
• cal-com-pp-cli oauth-clients get-by-id — <Warning>These endpoints are deprecated and will be removed in the future.</Warning>
• cal-com-pp-cli oauth-clients update — <Warning>These endpoints are deprecated and will be removed in the future.</Warning>

organizations — Manage organizations

routing-forms — Manage routing forms

schedules — Manage schedules

• cal-com-pp-cli schedules create — Create a schedule for the authenticated user. The point of creating schedules is for event types to be available at...
• cal-com-pp-cli schedules delete — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli schedules get — Get all schedules of the authenticated user. <Note>Please make sure to pass in the cal-api-version header value as...
• cal-com-pp-cli schedules get-default — Get the default schedule of the authenticated user. <Note>Please make sure to pass in the cal-api-version header...
• cal-com-pp-cli schedules get-scheduleid — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli schedules update — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...

selected-calendars — Manage selected calendars

• cal-com-pp-cli selected-calendars add — If accessed using an OAuth access token, the APPS_WRITE scope is required.
• cal-com-pp-cli selected-calendars delete — If accessed using an OAuth access token, the APPS_WRITE scope is required.

slots — Manage slots

• cal-com-pp-cli slots delete-reserved — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli slots get-available — There are 4 ways to get available slots for event type of an individual user: 1. By event type id. Example...
• cal-com-pp-cli slots get-reserved — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...
• cal-com-pp-cli slots reserve — Make a slot not available for others to book for a certain period of time. If you authenticate using oAuth...
• cal-com-pp-cli slots update-reserved — <Note>Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing...

stripe — Manage stripe

• cal-com-pp-cli stripe check — Check Stripe connection
• cal-com-pp-cli stripe redirect — Get Stripe connect URL
• cal-com-pp-cli stripe save — Save Stripe credentials

teams — Manage teams

• cal-com-pp-cli teams create — If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.
• cal-com-pp-cli teams delete — If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.
• cal-com-pp-cli teams get — If accessed using an OAuth access token, the TEAM_PROFILE_READ scope is required.
• cal-com-pp-cli teams get-teamid — If accessed using an OAuth access token, the TEAM_PROFILE_READ scope is required.
• cal-com-pp-cli teams update — If accessed using an OAuth access token, the TEAM_PROFILE_WRITE scope is required.

verified-resources — Manage verified resources

• cal-com-pp-cli verified-resources user-get-verified-email-by-id — If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.
• cal-com-pp-cli verified-resources user-get-verified-emails — If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.
• cal-com-pp-cli verified-resources user-get-verified-phone-by-id — If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.
• cal-com-pp-cli verified-resources user-get-verified-phone-numbers — If accessed using an OAuth access token, the VERIFIED_RESOURCES_READ scope is required.
• cal-com-pp-cli verified-resources user-request-email-verification-code — Sends a verification code to the email. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE...
• cal-com-pp-cli verified-resources user-request-phone-verification-code — Sends a verification code to the phone number. If accessed using an OAuth access token, the...
• cal-com-pp-cli verified-resources user-verify-email — Use code to verify an email. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is required.
• cal-com-pp-cli verified-resources user-verify-phone-number — Use code to verify a phone number. If accessed using an OAuth access token, the VERIFIED_RESOURCES_WRITE scope is...

webhooks — Manage webhooks

• cal-com-pp-cli webhooks create — If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.
• cal-com-pp-cli webhooks delete — If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.
• cal-com-pp-cli webhooks get — Gets a paginated list of webhooks for the authenticated user. If accessed using an OAuth access token, the...
• cal-com-pp-cli webhooks get-webhookid — If accessed using an OAuth access token, the WEBHOOK_READ scope is required.
• cal-com-pp-cli webhooks update — If accessed using an OAuth access token, the WEBHOOK_WRITE scope is required.