Google Calendar | ElevenLabs Documentation

Overview

Connect your ElevenLabs AI agents with Google Calendar to manage scheduling and calendar appointments. This integration enables your agents to check availability, create, update, and delete events with attendees and optional Google Meet conferencing, list upcoming events, and discover accessible calendars through natural conversation.

Capabilities

Capability	Support
Zero retention mode (ZRM)	Not supported
Attachments in tools	Not supported — tools operate on text only

Security warning

Security warning: google_calendar_update_event and google_calendar_delete_event are privileged tools. They run with the connected Google account’s full calendar access, not just access to events your agent created. Anyone who can talk to the agent can change or cancel any event on that calendar, including events they did not create, because the agent can look up event IDs with google_calendar_list_events. A confirmation in the system prompt is a hint to the model, not a security control.

Only enable these tools on agents with authentication enabled, or where the event ID comes from a trusted source. Do not add them to public agents. Attendees are always notified when an event is updated or deleted.

Setup

This integration uses Google OAuth 2.0 for authentication. You authorize ElevenLabs to access your Google Calendar on your behalf.

Click Connect in ElevenLabs

In the ElevenLabs integration setup, click Connect. You are redirected to Google to authorize access.

Select your Google account

Choose the Google account whose calendar data your agent should access. If your browser is signed into multiple Google accounts, select the correct one.

Authorize calendar access

Review the permissions requested and click Allow. The integration requests access to manage events on calendars you own, view your calendar list, and check free/busy information.

OAuth scopes

The integration requests the following Google OAuth 2.0 scopes:

Scope	Purpose
`calendar.events.owned`	Create, read, update, and delete events on calendars you own.
`calendar.calendarlist.readonly`	View the list of calendars accessible to your account (names and IDs).
`calendar.freebusy`	Check free/busy availability across calendars without exposing event details.

How it works

The agent schedules meetings by using tool calls to step through the booking process. The tabs below show a high-level summary and a detailed system prompt.

High-level overview

Detailed system prompt

Discover calendars

The agent lists accessible calendars to identify the correct one for scheduling. For most users, this is the primary calendar.

Check availability

The agent checks free/busy availability by:

Using the google_calendar_check_availability tool to query busy time blocks.
Verifying whether the requested time is open.
Suggesting alternatives if the requested time conflicts with an existing event.
Confirming the selected time with the caller.

Collect attendee details

Once a time is agreed upon, the agent:

Collects the attendee’s full name and email address.
Confirms the email by reading it back to the caller.
Verifies time zone information.

Create the event

The agent:

Calls the google_calendar_create_event tool with the confirmed details.
Optionally adds a Google Meet link if video conferencing is requested.
Confirms event creation and informs the attendee that they will receive a calendar invitation.

Agent tools

When you add Google Calendar tools to an agent, the following built-in tools are available:

Tool	Description
`google_calendar_check_availability`	Check free/busy availability for one or more calendars within a time range. Returns busy time blocks so the agent can find open slots. Use before creating events to avoid conflicts.
`google_calendar_create_event`	Create a new event on a Google Calendar with optional attendees, location, and Google Meet conferencing. Sends email notifications to all participants.
`google_calendar_list_events`	List upcoming events from a calendar within a time range, ordered by start time. Supports free-text search across event summaries, descriptions, locations, and attendee details.
`google_calendar_update_event`	Privileged. Update any event on the calendar, for example to reschedule it or change its title, location, or attendees. Only the fields provided are changed. Attendees are notified.
`google_calendar_delete_event`	Privileged. Delete any event on the calendar, cancelling it for all attendees. Use list events first to find the event ID. For recurring events, use an occurrence’s ID or its recurringEventId (whole series).
`google_calendar_list_calendars`	List all calendars accessible to the connected Google account. Returns calendar names and IDs. Use to discover which calendar to target before checking availability or creating events.