Katexs
Calendar tools

ToolsBeta

Calendar tools

Let agents check real availability and book, move and cancel appointments on Google Calendar, with double-booking protection.

Setup

  1. 1

    Connect Google Calendar

    In Tools, connect the Google account and calendar the agent should book into.

  2. 2

    Set booking rules

    Choose the time zone, business hours, appointment length and buffer between appointments.

  3. 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_availability and book_appointment.

  4. 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

SituationMessage
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