Skip to main content
Google Calendar tools let your agent check free times and manage events on a connected Google account. Each tool uses the fixed calendar_id you choose in its inputs.

Available tools

Add these tools from a prompt agent’s Functions menu or a conversation flow function node. They also work in agent workflows. Times are local ISO 8601 strings, such as 2026-12-03T14:00:00, paired with an IANA timezone such as America/Los_Angeles. Don’t convert the local time to UTC yourself. For a time window, end_time must be after start_time.

Book an appointment

A home services agent can check Thursday afternoon on the estimators’ calendar, offer a 30-minute opening, and book a visit after the caller confirms their time and email.
1

Check a bounded time window

Configure Check Availability with your calendar. Let the agent infer the requested date and timezone, or use custom input instructions to restrict checks to your business hours.The result contains free intervals, not appointment slots of a fixed length. Choose a start time that leaves room for the whole appointment inside an interval. Only the selected calendar’s busy times are checked; attendees’ calendars aren’t checked.
2

Configure Book Event

Choose the same calendar_id. Configure the required start_time, timezone, and title fields. Use Add input to include optional fields:For an attendee list collected during the call, choose Let AI infer, or Custom to set instructions for the list and its Every item fields. For a predetermined list, choose Array items and fill the numbered rows. See array inputs for both approaches.
3

Confirm the details and book

Instruct the agent to confirm the time, timezone, and attendee emails before calling Book Event. Google is asked to send invitations to all supplied attendees.Booking and rescheduling don’t recheck availability or reserve a slot in advance. Check availability close to the write, and don’t announce success until the tool succeeds.
4

Keep the event ID

In Function fields → Output, map event.event_id to a dynamic variable such as google_event_id. If the path isn’t listed, use Manually add fields to enter it. Pass {{google_event_id}} to a later Get Event, Reschedule Event, or Cancel Event tool using Value mode.Event responses also include the title, start and end times, attendee details, and html_link. See output field selection for choosing fields or adding a path manually.

Find or change an existing event

When you don’t have the event ID, use List Events with the attendee’s confirmed email and a narrow time window. It matches the event’s attendee email, not a name or email mentioned only in the title or notes. Ask the caller which result they mean before changing it. Use the selected event’s event_id with Reschedule Event or Cancel Event. Rescheduling keeps the original duration; both tools ask Google to notify all attendees. For a recurring event, use the ID of one occurrence returned by List Events. These tools reject changes to an entire recurring series, and Reschedule Event also rejects all-day events.

Test the configuration

Start with Check Availability or List Events on a calendar you control. In Run a test, supply concrete sample values for inferred inputs. For attendee arrays, add sample rows and fill every required email; Every item instructions aren’t executed by the test panel. Use an agent test to verify collection from a conversation.
Tests call Google Calendar for real. Testing Book Event, Reschedule Event, or Cancel Event changes calendar events and can send attendee notifications. Use a test calendar and addresses you control.

Troubleshooting

The tool subtracts busy times from the window you request. It doesn’t apply working hours, buffers, minimum notice, or Google appointment-schedule rules. Restrict the time window and tell the agent which hours it may offer.
Check the selected calendar, attendee email, and time window. An event created without that email in its attendee list won’t match. Narrow the search if there are many results; the tool returns a bounded list.
Check the connected Google account’s access to the selected calendar. A successful connection check doesn’t guarantee access to every calendar. Restore the calendar permissions or reconnect the account, then retry.