Google Calendar for AI agents
Agents read Google Calendar at once. Changes and sends are held for a person's approval by default.
About Google Calendar
Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization
What an agent can do in Google Calendar
Every Google Calendar action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Google Calendar without asking first. 19 actions.
- Get ACL RuleRetrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.
- Get Single Calendar by IDRetrieves metadata for a SINGLE specific calendar from the user's calendar list by its calendar ID. This action requires a calendarId parameter and returns details about that one calendar only. NOTE:
- Get EventRetrieves a SINGLE event by its unique event_id (REQUIRED). This action does NOT list or search events - it fetches ONE specific event when you already know its ID. If you want to list events within a
- Get Event InstancesReturns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExc
- List Events from All CalendarsReturn a unified event list across all calendars in the user's calendar list for a given time range. Use when you need a single view of all events across multiple calendars. An inverted or incorrect t
- Find eventFinds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types. Ensure `timeMin` is not chronologically after `timeMax` if both are pro
- Query Calendar AvailabilityQueries raw busy intervals for one or more calendars or groups over an exact time range. Returns per-calendar and per-group availability and errors, without event titles or details. Use GOOGLECALENDAR
- Get Google CalendarGets canonical metadata for one Google Calendar, defaulting to the authenticated user's primary calendar. Returns its identifier, title, description, location, time zone, and conference properties. Us
- List ACL RulesRetrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.
- Get Color DefinitionsReturns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.
- List EventsLists or incrementally synchronizes events from one calendar, defaulting to the connected user's primary calendar. Use timeMin/timeMax for a time window, singleEvents to expand recurring series, showD
- Find free slotsFinds both free and busy time slots in Google Calendars for specified calendars within a defined time range. If `time_min` is not provided, defaults to the current timestamp in the specified timezone.
Show all 19
- Get current date and timeGets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., 'tomorrow', 'next Monday') to avoid off-by-one-day errors across ti
- Get Current Google Calendar UserIdentifies the Google user connected to Calendar from the primary calendar resource. Returns the account identifier, email when available, display name, timezone, and primary calendar ID. This is Cale
- List BuildingsLists all buildings for a Google Workspace customer account with full details including addresses, coordinates, and floor names. Use this action when you need to retrieve the complete list of physical
- List Calendar ResourcesRetrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference spac
- List Google CalendarsLists calendars accessible through the connected user's CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders. Hidden calendars are om
- Get Calendar SettingTool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.
- List SettingsReturns all user settings for the authenticated user. Results include multiple settings keyed by id (e.g., `timeZone`); locate a specific setting by its `id` field. `timeZone` values are IANA identifi
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 28 actions.
- Delete ACL RuleDeletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.
- Create ACL RuleCreates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.
- Remove Calendar from ListTool to remove a calendar from the user's calendar list. Use when you need to unsubscribe from or hide a calendar from the user's list.
- Insert Calendar into ListInserts an existing calendar into the user's calendar list, making it visible in the UI. Calendars (e.g., newly created ones) won't appear in the list or UI until explicitly inserted.
- Patch Calendar List EntryUpdates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.
- Delete CalendarDeletes a secondary calendar that you own or have delete permissions on. Deletion is permanent and irreversible — verify the correct calendar_id before calling. You cannot delete your primary calendar
- Update CalendarFull PUT-style update that overwrites all calendar metadata fields; unspecified optional fields are cleared. Use GOOGLECALENDAR_PATCH_CALENDAR to update only a subset of fields. Mutates the underlying
- Stop ChannelTool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.
- Create a new calendarCreates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calenda
- Create EventCreates a timed event using start_datetime and either end_datetime or duration fields, or an all-day event using an inclusive start_date and exclusive end_date. send_updates defaults to "all", which e
- Delete eventDeletes an event from the specified calendar. Only Google's HTTP 204 confirms deletion; 404 or 410 can also mean the event belongs to a different calendar. Bulk deletions may trigger `rateLimitExceede
- Create a calendarCreates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if nee
Show all 28
- Patch CalendarPartially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for `descriptio
- Patch EventUpdate specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are vali
- Update Google eventUpdates an existing event in Google Calendar. REQUIRES event_id - you MUST first search for the event using GOOGLECALENDAR_FIND_EVENT or GOOGLECALENDAR_EVENTS_LIST to obtain the event_id. This is a fu
- Patch ACL RuleUpdates an existing access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. IMPORTANT: The ACL rule must al
- Update ACL RuleUpdates an access control rule for the specified calendar.
- Watch ACL ChangesTool to watch for changes to ACL resources. Use when you need to set up real-time notifications for access control list modifications on a calendar.
- Batch EventsExecute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migr
- Update Calendar List EntryUpdates a calendar list entry's display/subscription settings (color, visibility, reminders, selection) for the authenticated user — does not modify the underlying calendar resource (title, timezone,
- Watch Calendar ListWatch for changes to CalendarList resources using push notifications. Use this to receive real-time updates when calendar list entries are modified.
- Clear CalendarClears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely.
- Import EventTool to import an event as a private copy to a calendar. Use when you need to add an existing event to a calendar using its iCalUID. Only events with eventType='default' can be imported.
- Move EventMoves an event to another calendar, i.e., changes an event's organizer.
- Watch EventsWatch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts.
- Quick Add EventParses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring even
- Remove attendee from eventRemoves an attendee from a specified event in a Google Calendar; the calendar and event must exist. Concurrent calls on the same event can overwrite attendee lists — apply changes sequentially per eve
- Watch SettingsWatch for changes to Settings resources.
Changes wait in Needs you
Changes and sends in Google Calendar are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Google Calendar questions
Can an agent change data in Google Calendar on its own?
Not by default. Changes and sends in Google Calendar are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Google Calendar?
This connector lists 19 read actions. Reads run at once, without waiting for approval.
How does Google Calendar connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.