Google Calendar

Manage calendar events, check availability, and look up contacts via Google Calendar.

The Google Calendar integration enables your agent to create, update, and manage calendar events, check availability, and look up contacts.

Connecting Google Calendar

Prerequisites

• A Google account with Google Calendar access
• Project management permissions in PolyAI

Connection steps

1. Go to the Integrations page in Agent Studio
2. Find Google Calendar and click Connect
3. Select an environment (Sandbox, Pre-release, or Live)
4. Click Connect new account
5. Authenticate with your Google account via OAuth
6. You’ll be redirected back to PolyAI automatically

Available actions

Event management

Action	Description
Create Event	Create a new calendar event with name, times, attendees, location, and optional Google Meet link
Update Event	Update an existing event’s details such as name, time, location, or attendees
List Events	List calendar events with optional filtering by calendar and time range
Get Event by ID	Retrieve details of a specific calendar event
Delete Event	Delete a calendar event by event ID

Availability

Action	Description
Get Availability	Check availability and free/busy times for specified calendars within a time range

Contact lookup

Action	Description
Get Contacts	Retrieve user’s contacts with optional pagination
Search Contacts	Search user’s contacts by query string
List Directory People	List people from the organization’s directory
Search Directory People	Search people in the organization’s directory
List Other Contacts	List auto-created contacts
Search Other Contacts	Search auto-created contacts

Enabling actions

Reference Google Calendar actions in your agent’s prompts — either enable all actions or select specific ones. See the Zoom integration for detailed examples of this pattern.

Example use case

Scheduling assistant:

You are a scheduling assistant. When a user wants to book a meeting:
1. Check the calendar for availability
2. Suggest open time slots
3. Create the event with the agreed time, attendees, and a Google Meet link

Troubleshooting

Issue	Solution
Integration not appearing	Verify the feature is enabled for your account and you have project management permissions
Agent can’t access calendar	Check that Google Calendar is connected for the correct environment and the account has calendar permissions
OAuth errors	Ensure pop-ups are not blocked, clear browser cache, or try a different browser

Support

For additional help, contact PolyAI support.