Google Calendar
Connect your agent to Google Calendar to view upcoming events, schedule meetings, check availability, and manage your calendar — all through natural conversation.
Setup
1. Go to the Google Cloud Console → APIs & Services → Enable the Google Calendar API.
2. Create an OAuth 2.0 Client ID (Web application type). Note the Client ID and Client Secret.
3. Use the Google OAuth Playground (developers.google.com/oauthplayground) to authorize the https://www.googleapis.com/auth/calendar scope and obtain a Refresh Token.
4. In your agent's Settings, enable Google Calendar and enter all three credentials.
Tools
| Tool | Description |
|---|---|
| gcal_list_calendars | List all accessible calendars and their IDs |
| gcal_list_events | List upcoming events with optional date range and search |
| gcal_create_event | Create events with attendees, location, description, and Google Meet |
| gcal_update_event | Reschedule or modify existing events |
| gcal_delete_event | Cancel/delete events |
| gcal_find_free_time | Check free/busy availability across calendars |
Creating Events
Events support all-day dates (2025-03-20) or specific times (2025-03-20T14:00:00-05:00). Add attendees by email, set a location, and optionally attach a Google Meet link with add_meet: true.
Checking Availability
Use gcal_find_free_time to check when calendars are free or busy in a given time range. This is useful for finding open slots before scheduling meetings.
Events
Calendar actions emit events to execution history for monitoring. These events are not public automation triggers:
| Event | When |
|---|---|
| gcal.event_created | A new calendar event is created |
| gcal.event_updated | An event is modified |
| gcal.event_deleted | An event is deleted |
Example
User: "Schedule a catch-up tomorrow at 10am for 30 minutes with alex@example.com and sam@example.com, add a Meet link"
Agent: Creates a calendar event with the specified time, attendees, and Google Meet conference link.
Integration Ideas
Combine with Slack to post daily agenda summaries. Use with Scheduled Actions for "every morning, check my calendar and brief me." Pair with Timers for pre-meeting reminders.