Google Calendar Integration
Connect your assistant to Google Calendar for seamless appointment scheduling and availability checking.
The Google Calendar integration allows your Vapi assistant to interact with Google Calendar in two ways:
- Create calendar events through voice commands
- Check calendar availability for scheduling
This enables your assistant to schedule appointments, meetings, and other calendar events directly during phone calls, as well as check when you’re available for meetings.
Prerequisites
Before you can use the Google Calendar integration, you need to:
- Have a Google Calendar account
- Have access to the Vapi Dashboard
- Have an assistant created in Vapi
Setup Steps
1. Connect Google Calendar Account
First, you need to connect your Google Calendar account to Vapi:
- Navigate to the Vapi Dashboard
- Go to Providers Keys > Tools Provider > Google Calendar
- Click the Connect button
- A Google authorization popup will appear
- Follow the prompts to authorize Vapi to access your Google Calendar
The authorization process will request access to your Google Calendar to create events and check availability.

2. Create Calendar Tools
After connecting your Google Calendar account, create the tools:
- Go to Dashboard > Tools page
- Click the Create Tool button
- Select Google Calendar from the available options
- Choose which tool(s) you want to create:
- Google Calendar Create Event Tool
- Google Calendar Check Availability Tool
- For each tool, provide a name and description explaining when it should be invoked
The description field is crucial as it helps the AI model understand when and how to use each tool. Be specific about the scenarios and conditions when each tool should be invoked.

3. Add Tools to Assistant
Now, add your chosen calendar tool(s) to your assistant:
- Navigate to Dashboard > Assistants page
- Select your assistant
- Go to the Tools tab
- In the tools dropdown, select the calendar tool(s) you want to use
- Click Publish to save your changes

Tool Configurations
Google Calendar Create Event Tool
This tool uses the following fields to create events:
summary
: The title or description of the calendar eventstartDateTime
: The start date and time of the eventendDateTime
: The end date and time of the eventtimeZone
: The timezone for the event
Google Calendar Check Availability Tool
This tool uses the following fields to check availability:
startDateTime
: The start of the time range to checkendDateTime
: The end of the time range to checktimeZone
: The timezone for the availability check
All datetime fields should be provided in ISO 8601 format.
Example Usage
Here’s how the tools can be used in your assistant’s configuration:
Best Practices
- Clear Instructions: Provide clear instructions in your assistant’s system message about when to use each calendar tool
- Error Handling: Include fallback responses for cases where either calendar tool fails
- Time Zone Awareness: Always specify the correct timezone for events and availability checks
- Event Details: Ensure all required fields are properly filled when creating events
- Availability Flow: Check availability before attempting to schedule events to avoid conflicts