ToolsBeta
Calendar tools
Let agents check real availability and book, move and cancel appointments on Google Calendar, with double-booking protection.
Setup
- 1
Connect Google Calendar
In Tools, connect the Google account and calendar the agent should book into.
- 2
Set booking rules
Choose the time zone, business hours, appointment length and buffer between appointments.
- 3
Enable the tools on an agent
Open the agent's Tools tab and enable the calendar tools it needs. Most booking agents need
check_availabilityandbook_appointment. - 4
Tell the agent when to use them
Add rules to the prompt, for example "Always check availability before offering a time. Book only after the caller confirms the time and their name."
Tools
check_availability
Returns up to five open slots between two dates, read out in the calendar's time zone.
- startDatestringrequired
- First day to search,
YYYY-MM-DD. - endDatestringrequired
- Last day to search,
YYYY-MM-DD. Must be on or after startDate, at most 14 days later.
book_appointment
Books a slot after re-checking it is still free. Creates or links the contact and stores the booking.
- namestringrequired
- Caller's full name, 1 to 120 characters.
- startstringrequired
- Start time as an ISO 8601 date-time.
- phonestring
- Caller's phone. On voice calls the caller's number is used if omitted.
- emailstring
- Caller's email address.
- notesstring
- Up to 1000 characters, added to the calendar event.
reschedule_appointment
- bookingIduuidrequired
- The booking returned when it was created.
- newStartstringrequired
- New start time, ISO 8601.
cancel_appointment
- bookingIduuidrequired
- The booking to cancel.
Double-booking protection
Availability is checked twice: once when the agent offers times, and again immediately before the event is created. If someone else took the slot in between, the agent hears "That time was just taken. Let me check another slot for you." and offers another.
Messages the agent may say
| Situation | Message |
|---|---|
| Calendar not connected | "Calendar booking isn't connected yet. I can take your details and have the team confirm a time." |
| Invalid or missing details | "I didn't get everything I need for that. Could you repeat the details?" |
| Slot taken | "That time was just taken. Let me check another slot for you." |
| Booking not found | "I couldn't find that booking. It may have already been cancelled." |
| Anything else failed | "That didn't go through on my side. The team will follow up to confirm." |
Note
Bookings can only be changed or cancelled within the workspace that created them, and only for the contact who owns them.
Last updated November 2026 · Found a problem? Email support@katexs.com
