Connect Google Calendar to Retell AI with one Google sign-in so agents check free times and book, reschedule, or cancel calendar events during calls.
Connect Google Calendar to Retell with one Google sign-in so your agents can check free times and book, reschedule, or cancel events during a conversation. Multiple agents can share one workspace-level connection.
When to use it
Connect Google Calendar when your team’s schedule already lives there and you want callers handled end to end. It’s the right choice when you want to:
Offer real openings. The agent reads the calendar’s busy times and offers only times that are free.
Book while the caller is on the line. After the caller confirms a time, the agent creates the event, and Google emails an invitation to each attendee.
Move or cancel existing events. The agent finds the caller’s event by their email, then moves it to a new time (keeping its length) or cancels it and notifies the attendees.
For example, a home services company’s inbound agent checks the estimators’ calendar for Thursday afternoon, books a 2pm visit, and the homeowner gets the invitation by email before the call ends.Retell’s Google Calendar integration calculates availability from busy times on one calendar. It doesn’t apply booking-page rules, business hours, buffers, or minimum notice. Tell your agent which hours to offer in its prompt. For event-type scheduling rules, see Cal.com or Calendly.
Prerequisites
A Google account with edit access to the calendars your agents should book into. The calendar picker lists calendars the connected account can edit.
In the Retell Dashboard, open Integrations → Available. Find Google Calendar and click Connect, or Add if an account is already connected.
2
Name and authorize the connection
Enter a Connection name, such as Google Calendar - Scheduling. Click Connect or Add Account, then sign in to the Google account with access to your calendar and grant the requested permissions.
Name the Google Calendar connection before continuing to Google sign-in.
3
Verify the connection
Return to Integrations → Connected and confirm the connection appears without a Connection error label. You can now select it from an agent’s function menu.
Choose a calendar for each tool
Add a Google Calendar tool to a prompt agent or a conversation flow. In Function fields → Input, set calendar_id to the calendar the tool should use. Use the same calendar for availability, booking, and later changes to that booking.calendar_id must be a fixed value; the agent can’t infer it or fill it from a dynamic variable. The Select control lists calendar IDs the connected account can edit. If Retell can’t load the list, the field accepts a calendar ID as Value instead.For booking inputs, attendee lists, and response variables, see Google Calendar agent functions.
How access works
Retell requests three Google OAuth scopes:
calendar.events: view and edit events on your calendars, so the agent can book, reschedule, and cancel appointments.
calendar.freebusy: view your availability, so the agent can offer open times.
calendar.calendarlist.readonly: see the list of calendars you’re subscribed to, so you can choose which calendar the agent uses.
Retell AI’s use and transfer of information received from Google APIs will adhere to the Google API Services User Data Policy, including the Limited Use requirements.When you connect Google Calendar, Retell AI accesses your calendar list, availability and events only so your AI agent can check availability and book, reschedule or cancel appointments on your behalf. We do not sell Google user data or use it for advertising. Our staff do not read it except with your consent, for security purposes, or to comply with the law.We do not use Google user data, including raw, aggregated, anonymized or derived data, to develop, improve or train generalized AI or machine learning models, and we do not transfer it to third-party AI providers that use it for that purpose. To generate your agent’s responses, this data may be processed by AI model providers under terms that prohibit them from training on it. Some models run entirely within Retell AI’s own infrastructure, and data processed by them is never sent to the model provider.
FAQ
The connection or calendar picker fails
Confirm you signed in to the intended Google account and granted all three permissions listed above. For an existing connection, open its settings from Integrations → Connected and reconnect. If a calendar is missing from the picker, check that the connected Google account has edit access to it.
Which calendar does the agent book into?
The one you choose when you add a Google Calendar function to an agent. Retell lists every calendar the connected account can edit, so a shared team calendar works as long as that account has edit access.
Can the agent reschedule or cancel recurring events?
Only single occurrences. The agent can’t move or cancel a whole recurring series, and it can’t reschedule all-day events.
Next steps
Google Calendar agent functions
Configure availability checks, event booking, and changes to existing appointments.
Integrations overview
See every provider Retell connects to and how integration tools work.
Connect Cal.com
Book appointments with event types and booking rules.
Was this page helpful?
⌘I
Assistant
Responses are generated using AI and may contain mistakes.