Obtain a Personal Access Token or OAuth access token for the Calendly account that owns the event type.
Retrieve the event type URI by calling GET /event_types and locating the desired event type in the response.
Find an available time slot by calling GET /event_type_available_times with the event_type URI and the desired date range.
Create the booking by sending POST /invitees to api.calendly.com with a JSON body containing event_type (the event type URI), start_time (an available slot), invitee name, and invitee email.
Parse the response to obtain the scheduled event URI and confirmation details, then relay them to the end user.
Known gotchas
The Scheduling API endpoint is a flat POST to /invitees with event_type in the request body — it is NOT POST /scheduled_events/{uuid}/invitees.
Calendly API v1 was permanently shut down on August 27, 2025; all integrations must use the v2 API (api.calendly.com).
The Scheduling API requires the account to be on a paid Calendly plan; personal free-tier accounts cannot use it.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp