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 events with attendees and optional Google Meet conferencing, list upcoming events, and discover accessible calendars through natural conversation.

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