Calendly Quick Book
Book Calendly meetings via natural language. No tab switching, no link sending.
Default Configuration
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 |
Input Fields
| Field |
Required |
Example |
| Name |
Yes |
John Smith |
| Email |
Yes |
john@acme.com |
| 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}"
}
}'
Response Format
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 |
modbender