Calendly Quick Book
Book Calendly meetings via natural language. No tab switching, no link sending.
Default Configuration
| Setting |
Value |
| Default Calendly Link |
https://calendly.com/YOUR_USERNAME |
| Calendly Username |
YOUR_USERNAME |
Note: Update the values above with your own Calendly username after installation.
Commands
| Input |
Action |
book [name] [email] [timezone] [time] |
Book a meeting |
calendly book [name] [email] [timezone] [time] |
Book a meeting |
| Field |
Required |
Example |
| Name |
Yes |
John Smith |
| Email |
Yes |
[email protected] |
| Timezone |
Yes |
EST, PST, UTC |
| Time |
Yes |
tomorrow 2pm |
Timezone Mapping
| Input |
IANA Format |
| EST/EDT |
America/New_York |
| CST/CDT |
America/Chicago |
| MST/MDT |
America/Denver |
| PST/PDT |
America/Los_Angeles |
| GMT/UTC |
UTC |
API Workflow
Step 1: Get Current User
curl -s "https://api.calendly.com/users/me"
-H "Authorization: Bearer $CALENDLY_API_TOKEN"
Step 2: Get Event Types
curl -s "https://api.calendly.com/event_types?user={USER_URI}"
-H "Authorization: Bearer $CALENDLY_API_TOKEN"
Step 3: Get Available Times
curl -s "https://api.calendly.com/event_type_available_times?event_type={EVENT_TYPE_URI}&start_time={START_UTC}&end_time={END_UTC}"
-H "Authorization: Bearer $CALENDLY_API_TOKEN"
Step 4: Create Booking
curl -s -X POST "https://api.calendly.com/invitees"
-H "Authorization: Bearer $CALENDLY_API_TOKEN"
-H "Content-Type: application/json"
-d '{
"event_type": "{EVENT_TYPE_URI}",
"start_time": "{TIME_UTC}",
"invitee": {
"name": "{NAME}",
"email": "{EMAIL}",
"timezone": "{TIMEZONE_IANA}"
}
}'
Success
✅ Meeting Booked!
📅 [Date]
⏰ [Time] [Timezone]
👤 [Name] ([Email])
📍 Calendar invite sent automatically
No Availability
⚠️ No availability at [time]
Nearest slots:
1. [Option 1]
2. [Option 2]
3. [Option 3]
Errors
| Error |
Response |
| Invalid email |
Ask to confirm email |
| Token expired |
Direct to Calendly settings |
| No event types |
Direct to create one in Calendly |