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 |

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 |