calendly

1# Calendly
2 
3## Purpose
4Read and manage the user's Calendly: list upcoming scheduled events, event types, invitees for an event, and availability schedules; cancel bookings. Use when the user mentions Calendly, their bookings, or meeting links.
5 
6## Tooling
7All commands go through `bin/calendly.py`:
8 
9```bash
10bin/calendly.py auth                                          # verify the token, shows your user URI
11bin/calendly.py scheduled-events --user https://api.calendly.com/users/ABC123 --count 20
12bin/calendly.py event-types --user https://api.calendly.com/users/ABC123
13bin/calendly.py invitees --event-uuid abc123                # invitees for one event
14bin/calendly.py availability --user https://api.calendly.com/users/ABC123
15bin/calendly.py cancel --event-uuid abc123 --reason "conflict"
16```
17 
18`auth` returns the user URI; most commands need it as `--user`. `--event-uuid` is the last segment of the event URI. Time filters take ISO 8601, e.g. `--min-start-time 2026-09-16T00:00:00Z`.
19 
20## Auth
21- Provider id: `calendly` (credential is collected as `custom.calendly`)
22- Collection: OAuth 2.0 via the secure credential flow (`credentials.request_api_access`) (token endpoint `https://auth.calendly.com/oauth/token`), or a Personal Access Token from Calendly > Integrations > API & Webhooks
23- Allowed hosts: `api.calendly.com`
24- Status check: `bin/calendly.py auth` (must return `"ok": true`)
25…