> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Calendar

> Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization

![Google Calendar logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/googlecalendar.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=35fafeb01a7d590135ce7c96c9997f7c)

* **Category:** scheduling & booking
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 50
* **Triggers:** 7
* **Slug:** `GOOGLECALENDAR`
* **Version:** 20261103\_00

## Frequently Asked Questions

> [accordion] How do I set up custom Google OAuth credentials for Google Calendar?
>
> For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I seeing "App is blocked" when connecting Google Calendar?
>
> The OAuth client is requesting scopes that Google hasn't verified for that client. This usually happens when you add extra scopes beyond the defaults.
>
> Remove the additional scopes from your auth config, or create your own OAuth app and submit the scopes for verification. See [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).

> [accordion] Why am I getting "Google Calendar API has not been used in project" error?
>
> When using custom OAuth credentials, the Google Calendar API must be enabled in the Google Cloud project that owns those credentials. Enable it in Google Cloud Console under APIs & Services, wait a few minutes, and retry.

> [accordion] Why am I getting "Error 400: invalid\_scope"?
>
> The requested scopes are invalid or incorrectly formatted in the authorization URL. Verify your scope values against the [Google OAuth scopes docs](https://developers.google.com/identity/protocols/oauth2). If you're creating auth configs programmatically, see the [programmatic auth config guide](https://composio-preview.mintlify.site/docs/authentication/programmatic-auth-configs.md).

> [accordion] Why does the OAuth consent screen show "Composio" instead of my app?
>
> By default, the consent screen uses Composio's OAuth app. To show your own app name and logo, create your own OAuth app and set a custom redirect URL. See [White-labeling authentication](https://composio-preview.mintlify.site/docs/authentication/white-labeling-authentication.md#using-your-own-oauth-apps).

> [accordion] Why am I getting 401 errors on tool calls?
>
> The user's access token is no longer valid. Common causes: the user revoked access, changed their password or 2FA, a Workspace admin policy changed, or Google's refresh token limit (\~50 per account) was exceeded. Re-authenticating the user typically resolves this.

## Tools

> [accordion] Delete ACL Rule
>
> **Slug:** `GOOGLECALENDAR_ACL_DELETE`
>
> Deletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.
>
> #### Input Parameters
>
> **rule\_id** `string` *required*
>
> ACL rule identifier.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get ACL Rule
>
> **Slug:** `GOOGLECALENDAR_ACL_GET`
>
> Retrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.
>
> #### Input Parameters
>
> **rule\_id** `string` *required*
>
> ACL rule identifier. Format: 'scope\_type:scope\_value' or 'default'. Valid scope types: 'user' (email), 'group' (group email), 'domain' (domain name), 'default' (public access). Examples: 'user:[john@example.com](mailto:john@example.com)', 'group:[team@example.com](mailto:team@example.com)', 'domain:example.com', 'default'. Note: 'me' is NOT valid; use actual email/domain. The rule must exist - use GOOGLECALENDAR\_LIST\_ACL\_RULES to find valid IDs.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create ACL Rule
>
> **Slug:** `GOOGLECALENDAR_ACL_INSERT`
>
> Creates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.
>
> #### Input Parameters
>
> **role** `string ("none" | "freeBusyReader" | "reader" | "writer" | "owner")` *required*
>
> The role assigned to the scope. Possible values: "none" - Provides no access; "freeBusyReader" - Provides read access to free/busy information; "reader" - Provides read access to the calendar; "writer" - Provides read and write access to the calendar; "owner" - Provides ownership of the calendar.
>
> **scope** `object` *required*
>
> The extent to which calendar access is granted by this ACL rule. Specifies who gets the access (user, group, domain, or default).
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **send\_notifications** `boolean`
>
> Whether to send notifications about the calendar sharing change. Optional. The default is true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List ACL Rules
>
> **Slug:** `GOOGLECALENDAR_ACL_LIST`
>
> Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule\_id' values required for updating specific ACL rules.
>
> #### Input Parameters
>
> **pageToken** `string`
>
> Token specifying which result page to return. Optional.
>
> **syncToken** `string`
>
> Token obtained from the nextSyncToken field returned on the last page of a previous list operation. It makes the result of this list operation contain only entries that have changed since then. Optional. The default is to retrieve all entries.
>
> **calendarId** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **maxResults** `integer`
>
> Maximum number of entries returned on one result page. Optional. The default is 100.
>
> **showDeleted** `boolean`
>
> Whether to include deleted ACLs in the result. Optional. The default is False.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch ACL Rule
>
> **Slug:** `GOOGLECALENDAR_ACL_PATCH`
>
> Partially updates the role or scope of an existing Google Calendar access control rule. Provide at least one of role or scope; you can also choose whether to send sharing notifications. This operation modifies an existing rule rather than creating one.
>
> #### Input Parameters
>
> **role** `string`
>
> The role assigned to the scope. Possible values are: "none" - Provides no access; "freeBusyReader" - Provides read access to free/busy information; "reader" - Provides read access to the calendar (private events appear but details are hidden); "writer" - Provides read and write access to the calendar (private events and details are visible); "owner" - Provides ownership of the calendar (all permissions of writer plus ability to see and manipulate ACLs).
>
> **scope** `object`
>
> The extent to which calendar access is granted by this ACL rule. Optional for patch operations. Must include `type` (one of: 'user', 'group', 'domain', 'default') and `value` (email address or domain name) for all types except 'default'.
>
> **rule\_id** `string` *required*
>
> ACL rule identifier of an existing rule. IMPORTANT: The rule must already exist on the calendar - this action cannot create new rules, only modify existing ones. Use the ACL list action to find existing rule IDs, or use the ACL insert action to create a new rule first. Format: 'type:value', such as 'user:[email@example.com](mailto:email@example.com)' or 'group:[group@example.com](mailto:group@example.com)'.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **send\_notifications** `boolean`
>
> Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update ACL Rule
>
> **Slug:** `GOOGLECALENDAR_ACL_UPDATE`
>
> Updates an access control rule for the specified calendar.
>
> #### Input Parameters
>
> **role** `string` *required*
>
> The role assigned to the scope. Possible values are:  - "none" - Provides no access.  - "freeBusyReader" - Provides read access to free/busy information.  - "reader" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden.  - "writer" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible.  - "owner" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs.
>
> **rule\_id** `string` *required*
>
> ACL rule identifier.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **send\_notifications** `boolean`
>
> Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch ACL Changes
>
> **Slug:** `GOOGLECALENDAR_ACL_WATCH`
>
> Tool 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this channel.
>
> **type** `string`
>
> The type of delivery mechanism used for this channel. Valid values are "web\_hook" or "webhook".
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior. Optional.
>
> **address** `string` *required*
>
> The address where notifications are delivered for this channel.
>
> **calendarId** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Events
>
> **Slug:** `GOOGLECALENDAR_BATCH_EVENTS`
>
> Execute 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 migrations, cleanup, or large-scale updates.
>
> #### Input Parameters
>
> **fail\_fast** `boolean`
>
> If true, stop processing after the first batch containing any 4xx error (except 404 on DELETE). Default is false.
>
> **operations** `array` *required*
>
> List of batch operations to execute. Maximum 1000 operations per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Calendar from List
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_DELETE`
>
> Removes a calendar from the user's calendar list, unsubscribing from it without deleting the calendar itself.
>
> #### Input Parameters
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the 'primary' keyword.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Single Calendar by ID
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_GET`
>
> Retrieves 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: This does NOT list all calendars. To list all calendars in the user's calendar list, use GOOGLECALENDAR\_CALENDAR\_LIST\_LIST instead.
>
> #### Input Parameters
>
> **calendarId** `string` *required*
>
> Required. The calendar identifier for the single calendar to retrieve. Use 'primary' for the primary calendar of the authenticated user, or provide a specific calendar ID (e.g., an email address or group calendar ID). To find calendar IDs, first use GOOGLECALENDAR\_CALENDAR\_LIST\_LIST to list all calendars.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Insert Calendar into List
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_INSERT`
>
> Inserts an existing calendar into the user's calendar list, with optional display settings. The primary keyword is not accepted; provide the actual calendar ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The identifier of the calendar to insert. Must be a valid calendar ID in email format (e.g., ‘[user@example.com](mailto:user@example.com)’ for a user’s calendar or ‘[calendarid@group.calendar.google.com](mailto:calendarid@group.calendar.google.com)’ for a shared calendar). Note: The ‘primary’ keyword is not supported for this operation - use the actual email address of the primary calendar instead. The calendar must exist and you must have appropriate access permissions.
>
> **hidden** `boolean`
>
> Whether the calendar has been hidden from the list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
>
> **colorId** `string`
>
> The color of the calendar. This is an ID referring to an entry in the calendarCore color palette.
>
> **selected** `boolean`
>
> Whether the calendar is selected and visible in the calendar list. Accepts only boolean values: true or false. If not specified, the API defaults to false.
>
> **backgroundColor** `string`
>
> The background color of the calendar in the Web UI. (Hexadecimal color code)
>
> **foregroundColor** `string`
>
> The foreground color of the calendar in the Web UI. (Hexadecimal color code)
>
> **summaryOverride** `string`
>
> The summary that the authenticated user has set for this calendar.
>
> **color\_rgb\_format** `boolean`
>
> Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based colorId field will be set to the best matching option automatically. Optional. The default is False.
>
> **defaultReminders** `array`
>
> The default reminders that the authenticated user has for this calendar.
>
> **notificationSettings** `object`
>
> The notifications that the authenticated user is receiving for this calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Calendar List Entry
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_PATCH`
>
> Updates an existing calendar on the user's calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.
>
> #### Input Parameters
>
> **hidden** `boolean`
>
> Whether calendar is hidden.
>
> **colorId** `string`
>
> ID for calendar color from colors endpoint.
>
> **selected** `boolean`
>
> Whether calendar content shows in UI.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. Use "primary" keyword for the currently logged in user's primary calendar.
>
> **colorRgbFormat** `boolean`
>
> Whether to use RGB for foreground/background colors.
>
> **backgroundColor** `string`
>
> Hex color for calendar background.
>
> **foregroundColor** `string`
>
> Hex color for calendar foreground.
>
> **summaryOverride** `string`
>
> User-set summary for the calendar.
>
> **defaultReminders** `array`
>
> List of default reminders.
>
> **notificationSettings** `object`
>
> Notification settings for the calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Calendar List Entry
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_UPDATE`
>
> Updates 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, etc.). To modify the calendar itself, use GOOGLECALENDAR\_CALENDARS\_UPDATE.
>
> #### Input Parameters
>
> **hidden** `boolean`
>
> Whether calendar is hidden.
>
> **colorId** `string`
>
> ID for calendar color from colors endpoint.
>
> **selected** `boolean`
>
> Whether calendar content shows in UI.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier. Must be an actual calendar ID (e.g., "[examplecalendar@group.calendar.google.com](mailto:examplecalendar@group.calendar.google.com)" or "[c\_abc123...@group.calendar.google.com](mailto:c_abc123...@group.calendar.google.com)"). To retrieve valid calendar IDs, use the GOOGLECALENDAR\_LIST\_CALENDARS action first. The "primary" alias is not valid for calendarList.update.
>
> **colorRgbFormat** `boolean`
>
> Whether to use RGB for foreground/background colors.
>
> **backgroundColor** `string`
>
> Hex color for calendar background.
>
> **foregroundColor** `string`
>
> Hex color for calendar foreground.
>
> **summaryOverride** `string`
>
> User-set summary for the calendar.
>
> **defaultReminders** `array`
>
> List of default reminders.
>
> **notificationSettings** `object`
>
> Notification settings for the calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch Calendar List
>
> **Slug:** `GOOGLECALENDAR_CALENDAR_LIST_WATCH`
>
> Creates a push-notification channel for changes to the user's calendar list. Notifications signal changes rather than providing full change details, and delivery is not completely reliable.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this channel. Maximum 64 characters.
>
> **type** `string` *required*
>
> The type of delivery mechanism used for this channel. Must be "web\_hook" or "webhook".
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification. Maximum 256 characters. Used for channel verification and message routing.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior.
>
> **address** `string` *required*
>
> The HTTPS URL where notifications are delivered for this channel. Must have a valid SSL certificate.
>
> **expiration** `integer`
>
> Unix timestamp in milliseconds indicating when the API should stop sending notifications.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Calendar
>
> **Slug:** `GOOGLECALENDAR_CALENDARS_DELETE`
>
> Deletes 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 or calendars you only have read/write access to. Use calendarList.list to find calendars with owner accessRole. For primary calendars, use calendars.clear instead. Parallel calls may trigger userRateLimitExceeded; sequence bulk deletions.
>
> #### Input Parameters
>
> **calendar\_id** `string` *required*
>
> Calendar identifier for a secondary calendar you own or have delete permissions on. Use calendarList.list to find deletable calendar IDs (look for accessRole "owner"). Primary calendars cannot be deleted; use the Clear Calendar action instead.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Calendar
>
> **Slug:** `GOOGLECALENDAR_CALENDARS_UPDATE`
>
> Full 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 calendar resource (title, description, timeZone, etc.); use GOOGLECALENDAR\_CALENDAR\_LIST\_UPDATE to change per-user display properties like color.
>
> #### Input Parameters
>
> **summary** `string` *required*
>
> Title of the calendar. Must be a non-empty string; passing an empty string clears the calendar title.
>
> **location** `string`
>
> Geographic location of the calendar as free-form text. Optional.
>
> **timeZone** `string`
>
> The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) Optional.
>
> **calendarId** `string` *required*
>
> Calendar identifier. Use 'primary' to update the primary calendar of the currently logged in user, or provide a specific calendar ID (typically in email format like '[abc123@group.calendar.google.com](mailto:abc123@group.calendar.google.com)'). To retrieve calendar IDs call the calendarList.list method. IMPORTANT: This is NOT the calendar's display name/title. NOTE: For better performance, prefer providing the actual calendar ID instead of 'primary', as the 'primary' alias requires an additional API call to resolve.
>
> **description** `string`
>
> Description of the calendar. Optional.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Stop Channel
>
> **Slug:** `GOOGLECALENDAR_CHANNELS_STOP`
>
> Tool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this channel.
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
>
> **resourceId** `string` *required*
>
> An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Clear Calendar
>
> **Slug:** `GOOGLECALENDAR_CLEAR_CALENDAR`
>
> Clears 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.
>
> #### Input Parameters
>
> **calendar\_id** `string` *required*
>
> Primary calendar to clear: "`primary`" or the account's own email address. Google only clears primary calendars; secondary calendar IDs return 400 Invalid Value. To remove a secondary calendar's events, delete them individually or delete the calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Color Definitions
>
> **Slug:** `GOOGLECALENDAR_COLORS_GET`
>
> Returns the color definitions for calendars and events. Use when you need to retrieve the available color palette for styling calendars or events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a new calendar
>
> **Slug:** `GOOGLECALENDAR_CREATE_CALENDAR`
>
> Creates 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 calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone.
>
> #### Input Parameters
>
> **summary** `string` *required*
>
> Title of the calendar. This is the name that will be displayed in Google Calendar.
>
> **location** `string`
>
> Geographic location of the calendar as free-form text.
>
> **timezone** `string`
>
> The time zone of the calendar, specified as an IANA Time Zone Database name (e.g., 'America/New\_York', 'Europe/London', 'Asia/Tokyo'). If not specified, defaults to UTC.
>
> **description** `string`
>
> Description of the calendar. Provides additional context about the calendar's purpose.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Event
>
> **Slug:** `GOOGLECALENDAR_CREATE_EVENT`
>
> Creates a timed or all-day Google Calendar event and returns it under response\_data, without conflict checking. send\_updates defaults to "all", which emails all attendees; for eligible event types, the organizer is added unless excluded and a Google Meet link is requested by default.
>
> #### Input Parameters
>
> **summary** `string`
>
> Summary (title) of the event.
>
> **end\_date** `string`
>
> Exclusive end date for an all-day event in YYYY-MM-DD format. Must be provided together with start\_date and be later than start\_date.
>
> **location** `string`
>
> Geographic location of the event as free-form text.
>
> **timezone** `string`
>
> IANA timezone name from the timezone database (e.g., 'America/New\_York', 'Europe/London', 'Asia/Jerusalem', 'UTC'). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like 'EST', 'PST', 'ISRAEL TIME', or other abbreviations are NOT valid IANA timezone names.
>
> **attendees** `array`
>
> List of attendees. Each attendee can be either: (1) A string email address (e.g., '[user@example.com](mailto:user@example.com)'), or (2) An object with 'email' (required), 'optional' (boolean, default false), 'displayName' (string), 'comment' (string), 'additionalGuests' (integer), and 'resource' (boolean). To mark an attendee as optional (not required), use object format: \{'email': '[user@example.com](mailto:user@example.com)', 'optional': true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
>
> **eventType** `string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")`
>
> Type of the event, immutable post-creation. 'workingLocation' (REQUIRES Google Workspace Enterprise). Note: 'fromGmail' events cannot be created via API.
>
> **recurrence** `array`
>
> List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
>
> **start\_date** `string`
>
> Inclusive start date for an all-day event in YYYY-MM-DD format. Must be provided together with end\_date and without start\_datetime or end\_datetime.
>
> **visibility** `string ("default" | "public" | "private" | "confidential")`
>
> Event visibility: 'default', 'public', 'private', or 'confidential'.
>
> **calendar\_id** `string`
>
> Calendar identifier. Use 'primary' (recommended) for the user's main calendar. Alternatively, use a calendar ID from the user's accessible calendar list. Calendar IDs look like email addresses (e.g., '[xyz@group.calendar.google.com](mailto:xyz@group.calendar.google.com)' for shared calendars). Important: Arbitrary email addresses will NOT work - the calendar must exist in the user's calendar list with appropriate access permissions. Use GOOGLECALENDAR\_LIST\_CALENDARS to retrieve valid calendar IDs.
>
> **description** `string`
>
> Description of the event. Can contain HTML. Optional. Must be omitted for 'birthday' event type.
>
> **end\_datetime** `string`
>
> Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event\_duration\_hour and event\_duration\_minutes. If not provided, the end time is calculated using start\_datetime + duration. Must be after start\_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in `timezone`, or UTC when it is omitted.
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Options for who should receive notifications about event changes.
>
> **transparency** `string ("opaque" | "transparent")`
>
> 'opaque' (busy) or 'transparent' (available).
>
> **start\_datetime** `string`
>
> Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. Required for timed events; omit it when using start\_date and end\_date for an all-day event.
>
> **guestsCanModify** `boolean`
>
> If True, guests can modify the event.
>
> **exclude\_organizer** `boolean`
>
> If True, the organizer will NOT be added as an attendee. Default is False (organizer is included).
>
> **birthdayProperties** `object`
>
> Properties for birthday events.
>
> **create\_meeting\_room** `boolean`
>
> Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won't create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
>
> **event\_duration\_hour** `integer`
>
> Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event\_duration\_minutes instead. Ignored if end\_datetime is provided.
>
> **extended\_properties** `object`
>
> Extended properties of the event for storing custom metadata. Contains 'private' (visible only on this calendar) and/or 'shared' (visible to all attendees) dictionaries mapping string keys to string values. Example: \{'private': \{'key1': 'value1'}, 'shared': \{'key2': 'value2'}}
>
> **focusTimeProperties** `object`
>
> Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
>
> **guestsCanInviteOthers** `boolean`
>
> Whether attendees other than the organizer can invite others to the event.
>
> **outOfOfficeProperties** `object`
>
> Properties for outOfOffice events.
>
> **event\_duration\_minutes** `integer`
>
> Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event\_duration\_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end\_datetime is provided.
>
> **guestsCanSeeOtherGuests** `boolean`
>
> Whether attendees other than the organizer can see who the event's attendees are.
>
> **workingLocationProperties** `object`
>
> Properties for workingLocation events. REQUIRES Google Workspace Enterprise.  Constraints discovered from testing: - Must set transparency='transparent' and visibility='public' - Description must be omitted - Depending on 'type', include one of 'homeOffice', 'officeLocation', or 'customLocation'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete event
>
> **Slug:** `GOOGLECALENDAR_DELETE_EVENT`
>
> Deletes 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 `rateLimitExceeded` or `userRateLimitExceeded`; cap concurrency to 5–10 requests and apply exponential backoff.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> Unique identifier of the event to delete. For standalone events, use the base event ID (e.g., 'abc123def456'). For recurring event instances, use the instance ID format 'baseEventId\_YYYYMMDDTHHMMSSZ' (e.g., 'abc123def456\_20260522T093000Z') where the timestamp suffix represents the instance's original start time in UTC. Instance IDs can be obtained from the EVENTS\_INSTANCES action. To delete ALL occurrences of a recurring event, use the base event ID without the timestamp suffix. Must be the internal API identifier from a prior API response — UI-visible identifiers, URL-encoded variants, or shortened IDs are invalid and cause 404/validation errors.
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar (e.g., email address, specific ID, or 'primary' for the authenticated user's main calendar) from which the event will be deleted. Calendars without event-deletion permission, including subscribed calendars not owned by the authenticated user, return 403 on deletion attempts.
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Options for who should receive notifications about event changes.
>
> **send\_notifications** `boolean`
>
> Deprecated. Whether to send notifications about the deletion of the event. Note that some emails might still be sent.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a calendar
>
> **Slug:** `GOOGLECALENDAR_DUPLICATE_CALENDAR`
>
> Creates 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 needed.
>
> #### Input Parameters
>
> **summary** `string` *required*
>
> Title for the new Google Calendar to be created. Required and must be a non-empty string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Event
>
> **Slug:** `GOOGLECALENDAR_EVENTS_GET`
>
> Retrieves 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 time range, search for events, or filter by criteria like time\_min/time\_max, use GOOGLECALENDAR\_EVENTS\_LIST instead.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> REQUIRED. The unique identifier of the specific event to retrieve. You must already know this ID (e.g., from a previous EVENTS\_LIST call or event creation response). This action fetches ONE event by ID - it cannot list or search events. To find events by time range or search criteria, use GOOGLECALENDAR\_EVENTS\_LIST instead.
>
> **time\_zone** `string`
>
> Time zone used in the response. If not specified, the calendar's time zone is used.
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar (e.g., email address, specific ID, or 'primary' for the authenticated user's main calendar) from which to retrieve the event.
>
> **max\_attendees** `integer`
>
> Maximum number of attendees to include in the response. If there are more than the specified number, only the participant is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Import Event
>
> **Slug:** `GOOGLECALENDAR_EVENTS_IMPORT`
>
> Tool 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.
>
> #### Input Parameters
>
> **end** `object` *required*
>
> The (exclusive) end time of the event. For all-day events, use 'date' field; for timed events, use 'dateTime' and 'timeZone' fields.
>
> **start** `object` *required*
>
> The (inclusive) start time of the event. For all-day events, use 'date' field; for timed events, use 'dateTime' and 'timeZone' fields. `dateTime` must be ISO 8601 format (e.g., `'2024-01-15T10:00:00'`); `timeZone` should match the calendar's timezone to avoid shifted times.
>
> **source** `object`
>
> Source from which the event was created.
>
> **status** `string`
>
> Status of the event. Possible values: 'confirmed', 'tentative', 'cancelled'.
>
> **colorId** `string`
>
> The color of the event. This is an ID referring to an entry in the event colors definition.
>
> **iCalUID** `string` *required*
>
> Event unique identifier as defined in RFC5545. This is required to identify the event being imported.
>
> **summary** `string`
>
> Title of the event.
>
> **location** `string`
>
> Geographic location of the event as free-form text.
>
> **sequence** `integer`
>
> Sequence number as per iCalendar.
>
> **attendees** `array`
>
> The attendees of the event.
>
> **reminders** `object`
>
> Information about the event's reminders for the authenticated user.
>
> **recurrence** `array`
>
> List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Each string must include the full prefix (e.g., `'RRULE:FREQ=WEEKLY;BYDAY=MO'`); omitting the prefix causes a 400 error.
>
> **visibility** `string`
>
> Visibility of the event. Possible values: 'default', 'public', 'private', 'confidential'. Default: 'default'.
>
> **attachments** `array`
>
> File attachments for the event.
>
> **calendar\_id** `string`
>
> Calendar identifier. Use 'primary' for the logged-in user's primary calendar or the calendar's email address.
>
> **description** `string`
>
> Description of the event. Can contain HTML.
>
> **transparency** `string`
>
> Whether the event blocks time on the calendar. Possible values: 'opaque' (blocks time), 'transparent' (does not block time). Default: 'opaque'.
>
> **guestsCanModify** `boolean`
>
> Whether attendees other than the organizer can modify the event. Default: False.
>
> **extendedProperties** `object`
>
> Extended properties of the event.
>
> **supportsAttachments** `boolean`
>
> Whether API client performing operation supports event attachments. Default: False.
>
> **conferenceDataVersion** `integer`
>
> Version number of conference data supported by the API client. Version 0 assumes no conference data support and ignores conference data in the event's body. Version 1 enables copying of ConferenceData as well as for creating new conferences using the createRequest field of conferenceData. Default: 0.
>
> **guestsCanInviteOthers** `boolean`
>
> Whether attendees other than the organizer can invite others to the event. Default: True.
>
> **guestsCanSeeOtherGuests** `boolean`
>
> Whether attendees other than the organizer can see who the event's attendees are. Default: True.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Event Instances
>
> **Slug:** `GOOGLECALENDAR_EVENTS_INSTANCES`
>
> Returns 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 rateLimitExceeded or 429 too\_many\_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying.
>
> #### Input Parameters
>
> **eventId** `string` *required*
>
> REQUIRED. The ID of the recurring event whose instances you want to retrieve. You must first use GOOGLECALENDAR\_FIND\_EVENT or GOOGLECALENDAR\_EVENTS\_LIST to find recurring events and get their IDs. This action only works with recurring events that have a recurrence rule.
>
> **timeMax** `string`
>
> Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset.
>
> **timeMin** `string`
>
> Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset.
>
> **timeZone** `string`
>
> Time zone used in the response. Optional. The default is the time zone of the calendar.
>
> **pageToken** `string`
>
> Token specifying which result page to return. Optional.
>
> **calendarId** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the `calendarList.list` method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **maxResults** `integer`
>
> Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.
>
> **showDeleted** `boolean`
>
> Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events will still be included if `singleEvents` is False. Optional. The default is False.
>
> **maxAttendees** `integer`
>
> The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.
>
> **originalStart** `string`
>
> The original start time of the instance in the result. Optional.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Events
>
> **Slug:** `GOOGLECALENDAR_EVENTS_LIST`
>
> Lists 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, showDeleted to include cancelled events, query for text search, orderBy to sort, pageToken to continue a page sequence, and syncToken to retrieve changes after a completed full sync. A sync token cannot be combined with event, text, property, time, update-time, or ordering filters; keep other parameters unchanged across sync pages. The final page returns nextSyncToken, and an expired token requires a new full sync after Google returns HTTP 410. Use fields to request a smaller partial response, including continuation tokens needed by the workflow.
>
> #### Input Parameters
>
> **query** `string`
>
> Free text search terms to find events that match these terms in various fields. Optional.
>
> **fields** `string`
>
> Google partial-response selector that limits which fields are returned. Use comma-separated fields and nested selectors, for example 'items(id,status,summary,start,end,updated),nextPageToken,nextSyncToken'. Include nextPageToken when paginating and nextSyncToken when synchronizing, and keep the same selector on every page and incremental-sync request.
>
> **iCalUID** `string`
>
> Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID.
>
> **orderBy** `string ("startTime" | "updated")`
>
> The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: "startTime", "updated". When set to "startTime", singleEvents must be true. The action automatically sets singleEvents=true when orderBy='startTime'.
>
> **timeMax** `string`
>
> Upper bound (exclusive) for an event's start time to filter by. Optional. If unset, no start-time upper bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin. TIMEZONE WARNING: If using UTC times (ending in 'Z') but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, '2026-01-19T00:00:00Z' to '2026-01-20T00:00:00Z' covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los\_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., '2026-01-19T00:00:00-08:00' for PST). NOTE: Natural language expressions like 'today', 'tomorrow', 'next week' are NOT supported.
>
> **timeMin** `string`
>
> Lower bound (exclusive) for an event's end time to filter by. Optional. If unset, no end-time lower bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax. TIMEZONE WARNING: If using UTC times (ending in 'Z') but the calendar is in a different timezone, the time window may not align with local calendar dates. For example, '2026-01-19T00:00:00Z' to '2026-01-20T00:00:00Z' covers 2026-01-18 4pm to 2026-01-19 4pm in America/Los\_Angeles (UTC-8). To query a specific local date, use timestamps with the appropriate local timezone offset (e.g., '2026-01-19T00:00:00-08:00' for PST). NOTE: Natural language expressions like 'today', 'tomorrow', 'next week' are NOT supported.
>
> **timeZone** `string`
>
> Time zone used in the response for formatting event times. Optional. Use an IANA time zone identifier (e.g., America/Los\_Angeles). Defaults to the user's primary time zone. Offsets (e.g., '-03:00', 'UTC+0') and abbreviations (e.g., 'IST', 'PST') are invalid. NOTE: This parameter only affects how event times are displayed in the response. It does NOT change how timeMin/timeMax filtering is interpreted. To query a specific local date, use timestamps with the appropriate timezone offset directly in timeMin/timeMax (e.g., '2026-01-19T00:00:00-08:00').
>
> **pageToken** `string`
>
> Opaque pagination token from a previous response's nextPageToken field. Must be the exact string returned by the API - do not use placeholder values like 'NEXT', 'next', '1', '2', etc. Omit this parameter for the first page. Keep the calendar, filters, fields selector, and syncToken unchanged while paging. Continue until nextPageToken is absent; nextSyncToken is returned only on the final page.
>
> **syncToken** `string`
>
> Token from nextSyncToken to return only entries changed since the last list. Cannot be combined with iCalUID, orderBy, privateExtendedProperty, q, sharedExtendedProperty, timeMin, timeMax, or updatedMin. Deletions since the previous list are always included; showDeleted cannot be false in this mode. Keep all other parameters identical to the initial full sync and retain this token while following pageToken values. The action automatically removes conflicting parameters when syncToken is provided. If Google returns HTTP 410, discard the token and perform a new full sync without syncToken.
>
> **calendarId** `string`
>
> Calendar identifier. Use "primary" for the user's main calendar, or a calendar ID from the user's accessible calendar list. Arbitrary email addresses will NOT work - the calendar must exist in the user's calendar list. Use GOOGLECALENDAR\_LIST\_CALENDARS to retrieve valid calendar IDs. Defaults to "primary". Empty strings will be treated as "primary". Do NOT use Composio internal IDs like connectedAccountId (which start with "ca\_") - these will be automatically replaced with "primary".
>
> **eventTypes** `array`
>
> Event types to return. Google accepts this query parameter more than once, so provide a list to include multiple types. A single string is also accepted for compatibility. If unset, returns all event types. Values: "birthday", "default", "focusTime", "fromGmail", "outOfOffice", "workingLocation".
>
> **maxResults** `integer`
>
> Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are more events matching the query. Incomplete pages can be detected by a non-empty nextPageToken field in the response. By default the value is 250 events. The page size can never be larger than 2500 events. Optional. Must be >= 1 if provided.
>
> **updatedMin** `string`
>
> Lower bound for an event's last modification time (RFC3339). When specified, entries deleted since this time are always included regardless of showDeleted. Optional.
>
> **showDeleted** `boolean`
>
> Include cancelled events (status="cancelled"). Optional; default is false. This surfaces cancelled (soft-deleted) events, not items in the Trash. When syncToken or updatedMin is used, deletions since those markers are included regardless of showDeleted. Recurring interaction: if singleEvents=false and showDeleted=false, cancelled instances of a recurring series may still be included; if showDeleted=true and singleEvents=true, only single deleted instances (not parent series) are returned.
>
> **maxAttendees** `integer`
>
> The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. Must be >= 1 if provided.
>
> **singleEvents** `boolean`
>
> Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is False.
>
> **alwaysIncludeEmail** `boolean`
>
> Deprecated and ignored.
>
> **showHiddenInvitations** `boolean`
>
> Whether to include hidden invitations in the result. Optional. The default is False. Hidden invitations are events where your attendee entry has responseStatus='needsAction' and attendees\[].self==true. When true, such invitations are included.
>
> **sharedExtendedProperty** `string`
>
> Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple times to return events that match all given constraints.
>
> **privateExtendedProperty** `string`
>
> Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple times to return events that match all given constraints.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Events from All Calendars
>
> **Slug:** `GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARS`
>
> Lists and deduplicates events across selected calendars or the user's calendar list for a time range. Returns a compact summary by default, with full event details available on request; per-calendar errors can make results incomplete.
>
> #### Input Parameters
>
> **q** `string`
>
> Free text search terms to find events that match these terms in any field, except for extended properties. Optional.
>
> **time\_max** `string` *required*
>
> Upper bound (exclusive) for an event's start time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
>
> **time\_min** `string` *required*
>
> Lower bound (inclusive) for an event's end time to filter by. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). If timezone offset is missing, UTC (Z) will be automatically appended. Required.
>
> **event\_types** `array`
>
> Event types to return. Optional.
>
> **calendar\_ids** `array`
>
> Optional list of specific calendar IDs to query. If not provided, all calendars from the user's calendar list will be queried.
>
> **show\_deleted** `boolean`
>
> Whether to include deleted events (with status equals 'cancelled') in the result. Optional. The default is False.
>
> **single\_events** `boolean`
>
> Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is True.
>
> **response\_detail** `string ("minimal" | "full")`
>
> Level of detail in the response. 'minimal' (default) returns only the compact summary\_view, omitting the large events array to reduce token usage. 'full' returns both summary\_view and the full detailed events array.
>
> **max\_results\_per\_calendar** `integer`
>
> Maximum number of events returned per calendar. Optional. If not provided, defaults to the API's default (250). Results may be paginated; follow `nextPageToken` in the response until absent to retrieve the complete event list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move Event
>
> **Slug:** `GOOGLECALENDAR_EVENTS_MOVE`
>
> Moves a default event to another calendar, changing its organizer. Other event types cannot be moved.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> Event identifier. To retrieve event identifiers call the events.list method.
>
> **calendar\_id** `string` *required*
>
> Calendar identifier of the source calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **destination** `string` *required*
>
> Calendar identifier of the destination calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Options for who should receive notifications about event changes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch Events
>
> **Slug:** `GOOGLECALENDAR_EVENTS_WATCH`
>
> Watch for changes to Events resources. Watch channels expire; persist the channel `id` per `calendarId` to re-establish watches after expiration or restarts.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this channel.
>
> **type** `string`
>
> The type of delivery mechanism used for this channel.
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior. Optional.
>
> **address** `string` *required*
>
> The address where notifications are delivered for this channel. Must be a publicly accessible HTTPS URL; http\:// or localhost URLs will not receive notifications.
>
> **payload** `boolean`
>
> A Boolean value to indicate whether payload is wanted. Optional.
>
> **calendarId** `string` *required*
>
> Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find event
>
> **Slug:** `GOOGLECALENDAR_FIND_EVENT`
>
> Finds events in a specified Google Calendar using text, time ranges, and event types. Results are returned in event\_data.event\_data and may span multiple pages; follow nextPageToken even when a page is empty.
>
> #### Input Parameters
>
> **query** `string`
>
> Free-text search terms to find events. This query is matched against various event fields including summary, description, location, attendees' details (displayName, email), and organizer's details. Cannot search by event\_id. Performs full-text match (not exact); broad terms may return unrelated events. For person-based matching, prefer attendees\[].email over display names. If results appear incomplete, use GOOGLECALENDAR\_EVENTS\_LIST with client-side filtering.
>
> **order\_by** `string`
>
> Order of events: 'startTime' (ascending by start time) or 'updated' (ascending by last modification time). Note: 'startTime' requires single\_events=true. Use 'updated' if you need to include recurring masters (e.g., cancelled series).
>
> **time\_max** `string`
>
> Upper bound (exclusive) for an event's start time to filter by. Only events starting before this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00') Set to the first instant after the desired period to avoid missing boundary events, especially all-day events (date-only fields). Overly wide ranges expand many recurring instances, causing large payloads and high latency — constrain to the minimum required window.
>
> **time\_min** `string`
>
> Lower bound (exclusive) for an event's end time to filter by. Only events ending after this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00') RFC3339 timestamps must include explicit timezone offsets; missing or mismatched offsets can silently exclude matching events. To align with the calendar's timezone, retrieve it via GOOGLECALENDAR\_GET\_CALENDAR.
>
> **page\_token** `string`
>
> Token from a previous response's `nextPageToken` to fetch the subsequent page of results. Always follow every `nextPageToken` until absent; skipping pagination silently omits events on busy calendars.
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar to query. IMPORTANT: This must be a valid calendar identifier, NOT a calendar name/title. Valid formats are: 'primary' (the authenticated user's primary calendar), an email address (e.g., '[user@example.com](mailto:user@example.com)'), or a calendar ID (e.g., '[abc123xyz@group.calendar.google.com](mailto:abc123xyz@group.calendar.google.com)'). To find the calendar ID for a named calendar, first use the List Calendars action (GOOGLECALENDAR\_LIST\_CALENDARS) to retrieve all available calendars with their IDs. 'primary' searches only the authenticated user's primary calendar; to search all calendars, retrieve each ID via GOOGLECALENDAR\_LIST\_CALENDARS and query separately.
>
> **event\_types** `array`
>
> Event types to include. Supported values: 'birthday', 'default', 'focusTime', 'outOfOffice', 'workingLocation'.
>
> **max\_results** `integer`
>
> Maximum number of events per page (1-2500).
>
> **updated\_min** `string`
>
> Lower bound (exclusive) for an event's last modification time to filter by. Only events updated after this time are included. When specified, events deleted since this time are also included, regardless of the `show_deleted` parameter. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00')
>
> **show\_deleted** `boolean`
>
> Include events whose status is 'cancelled'. This surfaces cancelled/deleted events, not a separate 'trash' view. Behavior with recurring events: when single\_events=true, only individual cancelled instances are returned (the recurring master is omitted); to include cancelled recurring masters, set single\_events=false. If updated\_min is provided, events deleted since that time are included regardless of this flag.
>
> **single\_events** `boolean`
>
> When true, recurring event series are expanded into their individual instances. When false, only the recurring master events are returned. Note: Ordering by 'startTime' requires singleEvents=true. For large calendars, it is strongly recommended to specify both timeMin and timeMax to limit the expansion window and improve performance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Find free slots
>
> **Slug:** `GOOGLECALENDAR_FIND_FREE_SLOTS`
>
> Queries busy intervals and calculates free gaps for specified calendars, without filtering by meeting duration; the range is limited to 89 days, and calendar errors produce empty free slots marked unreliable. Omitted start defaults to now, and omitted end to 23:59:59 on the applicable day in the specified timezone.
>
> #### Input Parameters
>
> **items** `array`
>
> List of calendar identifiers to query for free/busy information. Pass as a simple list of strings, e.g., \['primary'] or \['primary', '[user@example.com](mailto:user@example.com)']. Valid values include: 'primary' (authenticated user's main calendar), calendar IDs from the user's calendar list (typically ending in @group.calendar.google.com), or email addresses of users whose free/busy information you want to query. The FreeBusy API will return error information for any calendars that are not accessible or invalid in the response under the 'errors' key for each calendar. Calendars omitted from `items` or inaccessible are treated as free (not unknown), which can silently produce incorrect availability results.
>
> **time\_max** `string`
>
> End datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified `timezone`. If not provided, defaults to 23:59:59 of the day specified in `time_min` (if provided), otherwise defaults to 23:59:59 of the current day in the specified `timezone`. Maximum span between time\_min and time\_max is approximately 90 days per Google Calendar freeBusy API limit. `time_max` is exclusive; to cover a full day, set `time_max` to 00:00:00 of the following day in the target timezone rather than 23:59:59.
>
> **time\_min** `string`
>
> Start datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats. If provided without an explicit timezone, it is interpreted in the specified `timezone`. If not provided, defaults to the current timestamp in the specified `timezone` to ensure only future/bookable slots are returned. Maximum span between time\_min and time\_max is approximately 90 days per Google Calendar freeBusy API limit.
>
> **timezone** `string`
>
> IANA timezone identifier (e.g., 'America/New\_York', 'Europe/London', 'Asia/Tokyo'). Determines how naive `time_min`/`time_max` are interpreted and the timezone used in the response for `timeMin`, `timeMax`, busy periods, and calculated free slots. Note: 'local' is not supported; use a specific IANA timezone name.
>
> **group\_expansion\_max** `integer`
>
> Maximum calendar identifiers to return for a single group. Must be between 1 and 100 (inclusive). Values exceeding 100 will be rejected.
>
> **calendar\_expansion\_max** `integer`
>
> Maximum calendars for which FreeBusy information is provided. Must be between 1 and 50 (inclusive). Values exceeding 50 will be rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Query Calendar Availability
>
> **Slug:** `GOOGLECALENDAR_FREE_BUSY_QUERY`
>
> Queries 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\_FIND\_FREE\_SLOTS when you want default time bounds and computed free intervals; use GOOGLECALENDAR\_EVENTS\_LIST when you need event records.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> List of calendars and/or groups to query. Accepts either strings (e.g., \['primary', '[user@example.com](mailto:user@example.com)']) or objects with an 'id' field (e.g., \[\{'id': 'primary'}]). String values are automatically converted to the proper format. Only calendars with at least freeBusyReader-level access are queried; omitting shared/secondary calendars can hide real conflicts. Batch all attendees into one call to avoid 403 rateLimitExceeded or 429 tooManyRequests errors.
>
> **timeMax** `string` *required*
>
> The end of the interval for the query formatted as per RFC3339. Exclusive bound; must be greater than timeMin. Keep the timeMin–timeMax window within \~90 days; larger spans may return empty or degraded results.
>
> **timeMin** `string` *required*
>
> The start of the interval for the query formatted as per RFC3339. Must be strictly less than timeMax. For full-day windows, use local 00:00 in the target timezone to avoid DST/off-by-one errors.
>
> **timeZone** `string`
>
> Time zone used in the response. Optional. The default is UTC. Defaults to UTC, which skews working-hours analysis for users in other timezones; always supply a valid IANA timezone (e.g., 'America/New\_York').
>
> **groupExpansionMax** `integer`
>
> Maximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.
>
> **calendarExpansionMax** `integer`
>
> Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Google Calendar
>
> **Slug:** `GOOGLECALENDAR_GET_CALENDAR`
>
> Gets 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. Use GOOGLECALENDAR\_CALENDAR\_LIST\_GET for one calendar's user-specific list settings such as access role, color, visibility, selection, and default reminders; use GOOGLECALENDAR\_LIST\_CALENDARS to enumerate accessible calendars.
>
> #### Input Parameters
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar to retrieve. Must be 'primary' (the default) for the user's main calendar, or an email-like identifier (e.g., '[user@example.com](mailto:user@example.com)' or 'en.usa#[holiday@group.v.calendar.google.com](mailto:holiday@group.v.calendar.google.com)'). IMPORTANT: Calendar display names/titles (e.g., 'Work', 'Vacation') are NOT valid identifiers and will result in errors. To find a calendar's ID, use the LIST\_CALENDARS action which returns the 'id' field for each calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Calendar Profile (Deprecated)
>
> **Slug:** `GOOGLECALENDAR_GET_CALENDAR_PROFILE`
>
> DEPRECATED: Use CalendarListGet instead. Tool to retrieve the authenticated user's primary calendar profile. Use when you need to get information about the user's main calendar, including timezone, settings, and preferences.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current date and time
>
> **Slug:** `GOOGLECALENDAR_GET_CURRENT_DATE_TIME`
>
> Gets 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 timezones.
>
> #### Input Parameters
>
> **timezone** `string`
>
> Timezone specification. Accepts: (1) IANA timezone identifier (e.g., 'America/New\_York', 'Asia/Kolkata', 'Europe/London') - RECOMMENDED, (2) Common timezone abbreviations (e.g., 'PST', 'EST', 'CST', 'GMT', 'UTC') - will be auto-converted to IANA, or (3) Numeric UTC offset in hours (e.g., -5, 5.5). Use positive values for east of UTC, negative for west. Default 0 is UTC.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Current Google Calendar User
>
> **Slug:** `GOOGLECALENDAR_GET_CURRENT_USER`
>
> Identifies 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 Calendar identity metadata, not a full Google Account or People profile.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Buildings
>
> **Slug:** `GOOGLECALENDAR_LIST_BUILDINGS`
>
> Lists a page of buildings for a Google Workspace customer, including available addresses, coordinates, and floor names. Use the continuation token for further pages; Directory API access and appropriate administrator privileges are required.
>
> #### Input Parameters
>
> **customer** `string`
>
> The unique ID for the customer's Google Workspace account. Use 'my\_customer' alias to represent your account's customer ID. As an account administrator, this alias represents your account's customer ID.
>
> **pageToken** `string`
>
> Token to specify the next page in the list. Obtained from nextPageToken in a previous response. Omit for the first page.
>
> **maxResults** `integer`
>
> Maximum number of buildings to return per page. Defaults to 25 for optimal performance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calendar Resources
>
> **Slug:** `GOOGLECALENDAR_LIST_CALENDAR_RESOURCES`
>
> Retrieves 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 spaces, or other bookable calendar resources in an organization. The action supports filtering by resource category, capacity, building location, and other criteria. IMPORTANT: This requires Admin SDK Directory API access and appropriate admin permissions - it is NOT available for personal Gmail accounts, only Google Workspace domains.
>
> #### Input Parameters
>
> **query** `string`
>
> Search query to filter calendar resources. Each clause is 'field operator value'. Supported operators: '=' (exact match), '!=' (mismatch), ':' (prefix/HAS match — for prefix match, follow the value with '\*'). Supported logical operators: AND, NOT (in that order of precedence). IMPORTANT: Numeric comparison operators (>, \<, >=, \<=) are NOT supported by the Google Admin Directory API for this endpoint and will cause a 400 Bad Request — 'capacity' can only be filtered by exact equality (e.g., 'capacity=10'). Supported fields: generatedResourceName, name, buildingId, floor\_name, capacity, featureInstances.feature.name, resourceEmail, resourceCategory.
>
> **orderBy** `string`
>
> Specifies sorting order for results. Use field names like 'resourceId', 'resourceName', 'capacity', 'buildingId', 'floorName' optionally followed by ' desc' for descending order. Multiple fields can be separated by commas (e.g., 'buildingId, capacity desc').
>
> **customer** `string`
>
> The unique ID for the customer's Google Workspace account. Use 'my\_customer' as an alias for the account's customer ID.
>
> **pageToken** `string`
>
> Token for retrieving subsequent pages in paginated results. Use the nextPageToken from a previous response.
>
> **maxResults** `integer`
>
> Maximum number of results to return per page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Google Calendars
>
> **Slug:** `GOOGLECALENDAR_LIST_CALENDARS`
>
> Lists 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 omitted unless show\_hidden is true; min\_access\_role and show\_deleted provide additional filtering. Continue with page\_token until next\_page\_token is absent; for incremental synchronization, pass next\_sync\_token back as sync\_token. Use returned IDs, not display names, with event actions, and use GOOGLECALENDAR\_GET\_CALENDAR for canonical metadata about one known calendar.
>
> #### Input Parameters
>
> **page\_token** `string`
>
> Token for the page of results to return, from a previous response.
>
> **sync\_token** `string`
>
> Sync token from a previous list request to get only changed entries; showDeleted, showHidden, and pageToken are ignored if provided. Also ignores minAccessRole. An HTTP 410 Gone response means the token has expired; perform a full resync by omitting sync\_token.
>
> **max\_results** `integer`
>
> Maximum calendars to return on one page. Google defaults to 100 and allows at most 250. Follow next\_page\_token until absent to enumerate every accessible calendar.
>
> **show\_hidden** `boolean`
>
> Include calendars not typically shown in the UI.
>
> **show\_deleted** `boolean`
>
> Include deleted calendars in the result.
>
> **min\_access\_role** `string ("freeBusyReader" | "reader" | "writerWithoutPrivateAccess" | "writer" | "owner")`
>
> Minimum access role for returned calendars: 'freeBusyReader', 'reader', 'writerWithoutPrivateAccess', 'writer', or 'owner'. freeBusyReader calendars expose only free/busy slots. Omit this filter to include every accessible role.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calendar Settings (Deprecated)
>
> **Slug:** `GOOGLECALENDAR_LIST_SETTINGS`
>
> DEPRECATED: Use GOOGLECALENDAR\_SETTINGS\_LIST instead. Tool to return all user settings for the authenticated user. Use when you need to retrieve calendar settings.
>
> #### Input Parameters
>
> **pageToken** `string`
>
> Token for pagination to retrieve subsequent result pages
>
> **maxResults** `integer`
>
> Maximum number of settings to return
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Calendar
>
> **Slug:** `GOOGLECALENDAR_PATCH_CALENDAR`
>
> Partially 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 `description` or `location` clear them.
>
> #### Input Parameters
>
> **summary** `string`
>
> New title for the calendar; cannot be an empty string when provided. At least one of summary, description, location, or timezone must be provided.
>
> **location** `string`
>
> New geographic location of the calendar (e.g., 'Paris, France').
>
> **timezone** `string`
>
> New IANA Time Zone Database name for the calendar (e.g., 'Europe/Zurich', 'America/New\_York'). Calendars duplicated via GOOGLECALENDAR\_DUPLICATE\_CALENDAR may default to UTC; set the correct timezone explicitly after duplication.
>
> **calendar\_id** `string` *required*
>
> The unique identifier of the Google Calendar to update. Use 'primary' for the main calendar, or a calendar's unique ID (typically in email format like '[abc123@group.calendar.google.com](mailto:abc123@group.calendar.google.com)'). IMPORTANT: This is NOT the calendar's display name/title - use GOOGLECALENDAR\_LIST\_CALENDARS to find the 'id' field for a calendar.
>
> **description** `string`
>
> New description for the calendar.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Patch Event
>
> **Slug:** `GOOGLECALENDAR_PATCH_EVENT`
>
> Update 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 valid and the user has write access to the calendar.
>
> #### Input Parameters
>
> **source** `object`
>
> Input model for event source.
>
> **status** `string ("confirmed" | "tentative" | "cancelled")`
>
> Status of the event.
>
> **summary** `string`
>
> New title for the event.
>
> **color\_id** `string`
>
> Color ID for the event (1-11). Use GOOGLECALENDAR\_COLORS\_GET to retrieve available colors.
>
> **end\_time** `string`
>
> New end time (RFC3339 timestamp, e.g., '2024-07-01T11:00:00-07:00'). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in `timezone`, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format (exclusive end date). Optional when updating start\_time - the original event duration will be preserved if end\_time is not specified. Must be strictly after `start_time`; mismatched or mixed formats cause HTTP 400 `timeRangeEmpty`.
>
> **event\_id** `string` *required*
>
> The unique technical identifier of the event to update. IMPORTANT: This is NOT the event title/name. Event IDs are opaque strings typically base32hex encoded (5-1024 characters using lowercase a-v and digits 0-9). For recurring event instances, the ID format is 'baseEventId\_YYYYMMDDTHHMMSSZ' with an underscore separator (e.g., 'abc123def456\_20260115T100000Z'). To get an event ID, first use GOOGLECALENDAR\_FIND\_EVENT or GOOGLECALENDAR\_EVENTS\_LIST to search for events and retrieve their IDs. Use master event ID to update the entire recurring series; use instance ID to update only that occurrence — confirm scope before patching.
>
> **location** `string`
>
> New geographic location (physical address or virtual meeting link).
>
> **sequence** `integer`
>
> Sequence number as per iCalendar specification. Incremented on each event update.
>
> **timezone** `string`
>
> IANA Time Zone Database name for start/end times (e.g., 'America/Los\_Angeles'). Interprets offset-less values and sets the display/recurrence zone; Z or numeric offsets still identify the instant. When provided without start\_time or end\_time, updates the display zone of an existing timed event while preserving its instants. All-day events do not have a time zone.
>
> **attendees** `array`
>
> List of valid email addresses for attendees (e.g., '[user@example.com](mailto:user@example.com)'). Replaces existing attendees. Provide an empty list to remove all.
>
> **reminders** `object`
>
> Input model for reminders.
>
> **recurrence** `array`
>
> RRULE, EXRULE, RDATE and EXDATE lines per RFC5545 for recurring events. Replaces existing recurrence rules if provided.
>
> **start\_time** `string`
>
> New start time (RFC3339 timestamp, e.g., '2024-07-01T10:00:00-07:00'). Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in `timezone`, or UTC when it is omitted. For all-day events, use YYYY-MM-DD format. When only start\_time is provided without end\_time, the event's original duration is preserved automatically.
>
> **visibility** `string ("default" | "public" | "private" | "confidential")`
>
> Visibility of the event.
>
> **attachments** `array`
>
> File attachments (max 25). Each with 'fileUrl' (required) and optional 'title', 'mimeType'. Requires supportsAttachments=true.
>
> **calendar\_id** `string` *required*
>
> Identifier of the calendar. Use 'primary' for the primary calendar of the logged-in user. To find other calendar IDs, use the `calendarList.list` method. Must be provided in snake\_case format.
>
> **description** `string`
>
> New description for the event; can include HTML.
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Whether to send update notifications to attendees. Uses default user behavior if unspecified. Set explicitly to avoid unintended notifications when removing attendees or making bulk updates.
>
> **transparency** `string ("opaque" | "transparent")`
>
> Whether the event blocks time on the calendar. 'opaque' (default) blocks time, 'transparent' does not.
>
> **max\_attendees** `integer`
>
> Maximum attendees in response; does not affect invited count. If more, response includes organizer only. Must be positive.
>
> **rsvp\_response** `string ("needsAction" | "declined" | "tentative" | "accepted")`
>
> RSVP response status for the authenticated user. Updates only the current user's response status without affecting other attendees. Note: RSVP is only supported for regular calendar events (eventType='default'); attempting to RSVP to focusTime, outOfOffice, birthday, or workingLocation events will result in an error.
>
> **conference\_data** `object`
>
> Input model for conference data.
>
> **attendees\_omitted** `boolean`
>
> Whether attendees may have been omitted from the event's representation.
>
> **guests\_can\_modify** `boolean`
>
> Whether attendees other than the organizer can modify the event (default: false).
>
> **anyone\_can\_add\_self** `boolean`
>
> Whether anyone can invite themselves to the event (default: false).
>
> **extended\_properties** `object`
>
> Input model for extended properties.
>
> **supports\_attachments** `boolean`
>
> Client application supports event attachments. Set to `True` if so.
>
> **focus\_time\_properties** `object`
>
> Input model for focus time properties.
>
> **conference\_data\_version** `integer`
>
> API client's conference data support version. Set to 1 to manage conference details (e.g., Google Meet links); 0 (default) ignores conference data. Setting to 1 enables reading/preserving conference data but does not generate a new Meet link — use GOOGLECALENDAR\_UPDATE\_EVENT with `create_meeting_room=true` to create one.
>
> **guests\_can\_invite\_others** `boolean`
>
> Whether attendees other than the organizer can invite others (default: true).
>
> **out\_of\_office\_properties** `object`
>
> Input model for out-of-office properties.
>
> **guests\_can\_see\_other\_guests** `boolean`
>
> Whether attendees can see who the event's attendees are (default: true).
>
> **working\_location\_properties** `object`
>
> Input model for working location properties.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Quick Add Event
>
> **Slug:** `GOOGLECALENDAR_QUICK_ADD`
>
> Parses 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 events, and `calendar_id` must be valid if not 'primary'.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Required natural language input describing the event. It must contain at least one non-whitespace character. Google Calendar parses it for event details like title, date, and time.
>
> **calendar\_id** `string`
>
> Identifier of the calendar for the event. Use 'primary' for the main calendar, or provide a specific calendar ID (e.g., email address).
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Controls whether email notifications about the event creation are sent to attendees.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove attendee from event
>
> **Slug:** `GOOGLECALENDAR_REMOVE_ATTENDEE`
>
> Removes 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 event.
>
> #### Input Parameters
>
> **event\_id** `string` *required*
>
> Unique identifier of the event. For recurring events, target the master series ID or a specific instance ID; removing an attendee from one instance does not affect other instances in the series.
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar to which the event belongs; 'primary' signifies the user's main calendar.
>
> **attendee\_email** `string` *required*
>
> Email address of the attendee to remove. Must match an attendee email present on the event. If no match is found, the attendee was already removed or was never on the event.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Calendar Setting
>
> **Slug:** `GOOGLECALENDAR_SETTINGS_GET`
>
> Tool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.
>
> #### Input Parameters
>
> **setting** `string` *required*
>
> The identifier of the user setting to retrieve. Valid values include: autoAddHangouts, dateFieldOrder, defaultEventLength, format24HourTime, hideInvitations, hideWeekends, locale, remindOnRespondedEventsOnly, showDeclinedEvents, timezone, useKeyboardShortcuts, weekStart
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Settings
>
> **Slug:** `GOOGLECALENDAR_SETTINGS_LIST`
>
> Lists the authenticated user's calendar settings, returning a page of settings identified by their id fields. Supports pagination and incremental synchronization using a sync token.
>
> #### Input Parameters
>
> **pageToken** `string`
>
> Token specifying which result page to return.
>
> **syncToken** `string`
>
> Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.
>
> **maxResults** `integer`
>
> Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Watch Settings
>
> **Slug:** `GOOGLECALENDAR_SETTINGS_WATCH`
>
> Watch for changes to Settings resources.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> A UUID or similar unique string that identifies this channel.
>
> **type** `string` *required*
>
> The type of delivery mechanism used for this channel. Must be "web\_hook".
>
> **token** `string`
>
> An arbitrary string delivered to the target address with each notification delivered over this channel.
>
> **params** `object`
>
> Additional parameters controlling delivery channel behavior.
>
> **address** `string` *required*
>
> The address where notifications are delivered for this channel.
>
> **expiration** `integer`
>
> Unix timestamp in milliseconds specifying when the API should stop sending notifications for this channel.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sync Events (Deprecated)
>
> **Slug:** `GOOGLECALENDAR_SYNC_EVENTS`
>
> Deprecated: Retrieves a page of Google Calendar events for full or incremental synchronization, using a sync token for changes. Returns pagination and sync tokens; an expired token requires a new full synchronization.
>
> #### Input Parameters
>
> **page\_token** `string`
>
> Token for paginating results, from a previous response's `nextPageToken`. Repeat with each returned `nextPageToken` until no `nextPageToken` is returned; stopping early silently omits remaining events.
>
> **sync\_token** `string`
>
> Token for incremental sync, retrieving only changes since issued. A 410 GONE response indicates an expired token, requiring a full sync. Cannot be combined with `timeMin`, `timeMax`, `orderBy`, `query`, or `updatedMin`; mixing these causes the request to fail.
>
> **calendar\_id** `string`
>
> Google Calendar identifier; 'primary' refers to the authenticated user's main calendar.
>
> **event\_types** `array`
>
> Filters events by specified types (e.g., 'default', 'focusTime', 'outOfOffice', 'workingLocation'). All types returned if omitted.
>
> **max\_results** `integer`
>
> Max events per page (max 2500); Google Calendar's default is used if unspecified.
>
> **single\_events** `boolean`
>
> If True, expands recurring events into individual instances (excluding master event); otherwise, Google's default handling applies.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Google event
>
> **Slug:** `GOOGLECALENDAR_UPDATE_EVENT`
>
> Replaces an existing Google Calendar event using its event ID and required start time. Omitted fields can be cleared, but existing conference data is preserved by default when available; supply the desired event details for the replacement.
>
> #### Input Parameters
>
> **summary** `string`
>
> Summary (title) of the event.
>
> **event\_id** `string` *required*
>
> REQUIRED. The unique identifier of the event to update. This parameter is MANDATORY - events cannot be updated by title, date, or other criteria. You MUST first retrieve the event\_id by using GOOGLECALENDAR\_FIND\_EVENT or GOOGLECALENDAR\_EVENTS\_LIST to search for the event, then use the returned 'id' field here.
>
> **location** `string`
>
> Geographic location of the event as free-form text.
>
> **timezone** `string`
>
> IANA timezone name from the timezone database (e.g., 'America/New\_York', 'Europe/London', 'Asia/Jerusalem', 'UTC'). Required if datetime is naive. For recurring events, start and end must include a timeZone. If not provided, UTC is used. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC. IMPORTANT: Must be a valid IANA timezone identifier. Values like 'EST', 'PST', 'ISRAEL TIME', or other abbreviations are NOT valid IANA timezone names.
>
> **attendees** `array`
>
> List of attendees. Each attendee can be either: (1) A string email address (e.g., '[user@example.com](mailto:user@example.com)'), or (2) An object with 'email' (required), 'optional' (boolean, default false), 'displayName' (string), 'comment' (string), 'additionalGuests' (integer), and 'resource' (boolean). To mark an attendee as optional (not required), use object format: \{'email': '[user@example.com](mailto:user@example.com)', 'optional': true}. IMPORTANT: Only valid email addresses are accepted. Plain names cannot be used.
>
> **eventType** `string ("birthday" | "default" | "focusTime" | "outOfOffice" | "workingLocation")`
>
> Type of the event, immutable post-creation. 'workingLocation' (REQUIRES Google Workspace Enterprise). Note: 'fromGmail' events cannot be created via API.
>
> **recurrence** `array`
>
> List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies: DAILY, WEEKLY, MONTHLY, YEARLY. For recurring events, start.timeZone and end.timeZone must be present. UNTIL values follow RFC 5545: date-only (YYYYMMDD) for all-day events, or UTC datetime with Z suffix (YYYYMMDDTHHMMSSZ) for timed events. UNTIL values with time but missing Z suffix are auto-corrected. Provide an empty list to remove recurrence so the event becomes non-recurring.
>
> **visibility** `string ("default" | "public" | "private" | "confidential")`
>
> Event visibility: 'default', 'public', 'private', or 'confidential'.
>
> **calendar\_id** `string`
>
> Identifier of the Google Calendar where the event resides. The value 'primary' targets the user's primary calendar.
>
> **description** `string`
>
> Description of the event. Can contain HTML. Optional. Must be omitted for 'birthday' event type.
>
> **end\_datetime** `string`
>
> Event end time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. When provided, this parameter takes precedence over event\_duration\_hour and event\_duration\_minutes. If not provided, the end time is calculated using start\_datetime + duration. Must be after start\_datetime. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in `timezone`, or UTC when it is omitted.
>
> **send\_updates** `string ("all" | "externalOnly" | "none")`
>
> Options for who should receive notifications about event changes.
>
> **transparency** `string ("opaque" | "transparent")`
>
> 'opaque' (busy) or 'transparent' (available).
>
> **start\_datetime** `string` *required*
>
> REQUIRED. Event start time in ISO 8601 format: YYYY-MM-DDTHH:MM:SS. IMPORTANT: Natural language expressions like 'tomorrow', 'next Monday', '2pm tomorrow' are NOT supported and will be rejected. You must provide the exact date and time in ISO format. Explicit timezone information (Z or an offset) is preserved; offset-less values are interpreted in `timezone`, or UTC when it is omitted. Examples: '2025-01-16T13:00:00', '2025-01-16T13:00:00Z', '2025-01-16T13:00:00-05:00'.
>
> **guestsCanModify** `boolean`
>
> If True, guests can modify the event.
>
> **birthdayProperties** `object`
>
> Properties for birthday events.
>
> **create\_meeting\_room** `boolean`
>
> Defaults to True. When True, for CREATE operations creates a Google Meet link; for UPDATE operations preserves existing conference data if present, or adds a new Meet link if none exists. Google Workspace accounts will successfully receive a Meet link. Personal Gmail accounts and other unsupported accounts will gracefully fallback to creating an event without a Meet link when conference creation fails. Set to False to skip Meet link operations (won't create new or modify existing conference data). The fallback ensures event creation succeeds even when conference features are unavailable due to account limitations.
>
> **event\_duration\_hour** `integer`
>
> Number of hours for the event duration. Supports multi-day events (e.g., 240 hours = 10 days). For durations under 1 hour, use event\_duration\_minutes instead. Ignored if end\_datetime is provided.
>
> **extended\_properties** `object`
>
> Extended properties of the event for storing custom metadata. Contains 'private' (visible only on this calendar) and/or 'shared' (visible to all attendees) dictionaries mapping string keys to string values. Example: \{'private': \{'key1': 'value1'}, 'shared': \{'key2': 'value2'}}
>
> **focusTimeProperties** `object`
>
> Properties for focusTime events. REQUIRES Google Workspace Enterprise account with Focus Time feature enabled.
>
> **guestsCanInviteOthers** `boolean`
>
> Whether attendees other than the organizer can invite others to the event.
>
> **outOfOfficeProperties** `object`
>
> Properties for outOfOffice events.
>
> **event\_duration\_minutes** `integer`
>
> Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event\_duration\_hour=1 instead. Maximum value is 59. Combined duration (hours + minutes) must be greater than 0. Ignored if end\_datetime is provided.
>
> **guestsCanSeeOtherGuests** `boolean`
>
> Whether attendees other than the organizer can see who the event's attendees are.
>
> **workingLocationProperties** `object`
>
> Properties for workingLocation events. REQUIRES Google Workspace Enterprise.  Constraints discovered from testing: - Must set transparency='transparent' and visibility='public' - Description must be omitted - Depending on 'type', include one of 'homeOffice', 'officeLocation', or 'customLocation'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] Attendee Response Changed
>
> **Slug:** `GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGER`
>
> **Type:** poll
>
> Polling trigger that fires when any attendee's RSVP changes to accepted, declined, or tentative. Returns attendee info and current status.
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **showDeleted** `boolean`
>
> Whether to include deleted events in the results
>
> #### Payload
>
> **attendee\_email** `string`
>
> Email of the attendee whose RSVP changed
>
> **attendee\_name** `string`
>
> Display name of the attendee
>
> **calendar\_id** `string` *required*
>
> The calendar identifier
>
> **event\_html\_link** `string`
>
> Link to the event in Google Calendar
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **event\_summary** `string`
>
> Event title/summary
>
> **previous\_response\_status** `string`
>
> Previous RSVP status
>
> **response\_status** `string` *required*
>
> Current RSVP status (accepted, declined, tentative)

> [accordion] Event Canceled or Deleted
>
> **Slug:** `GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER`
>
> **Type:** poll
>
> Triggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event\_id, summary (if available), and cancellation timestamp.
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar to monitor
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> #### Payload
>
> **cancelled\_at** `string`
>
> Cancellation timestamp (from event.updated)
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **summary** `string`
>
> Event title/summary (may be missing for cancelled events)

> [accordion] Event Starting Soon
>
> **Slug:** `GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER`
>
> **Type:** poll
>
> Triggers when a calendar event is within a configured number of minutes from starting. Returns event details, time remaining, attendees, and join links when available.
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar to monitor
>
> **countdownWindowMinutes** `integer`
>
> Look-ahead window (in minutes) for upcoming events to evaluate
>
> **includeAllDay** `boolean`
>
> Whether to consider all-day events (default False)
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **minutesBeforeStart** `integer`
>
> Trigger when an event is within this many minutes from starting
>
> #### Payload
>
> **attendees** `array`
>
> List of attendees
>
> **calendar\_id** `string` *required*
>
> The calendar identifier
>
> **countdown\_window\_minutes** `integer` *required*
>
> Countdown window used for this trigger
>
> **creator\_email** `string`
>
> Email of the event creator
>
> **description** `string`
>
> Event description
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **hangout\_link** `string`
>
> Google Meet link for the conference, if available
>
> **html\_link** `string`
>
> Link to the event in Google Calendar
>
> **location** `string`
>
> Event location
>
> **minutes\_until\_start** `number`
>
> Minutes remaining until event starts (>= 0)
>
> **organizer\_email** `string`
>
> Email of the event organizer
>
> **start\_time** `string`
>
> Event start time in ISO format
>
> **start\_timestamp** `number`
>
> Event start time as UNIX epoch timestamp (UTC)
>
> **summary** `string`
>
> Event title/summary

> [accordion] Calendar Event Changes
>
> **Slug:** `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGER`
>
> **Type:** webhook
>
> **SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead. Real-time webhook trigger for calendar event changes. Returns event metadata only. For full event data, use Calendar Event Sync (polling trigger).
>
> #### Configuration
>
> **calendar\_id** `string`
>
> The unique identifier for the calendar
>
> **ttl** `integer`
>
> The time-to-live in seconds for the notification channel
>
> #### Payload
>
> **channel\_id** `string` *required*
>
> The unique identifier passed to identify this channel
>
> **resource\_id** `string` *required*
>
> The unique identifier of the resource
>
> **resource\_state** `string` *required*
>
> The state of the resource
>
> **resource\_url** `string` *required*
>
> The url for the resource

> [accordion] Event Created
>
> **Slug:** `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER`
>
> **Type:** poll
>
> Polling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info.
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **showDeleted** `boolean`
>
> Whether to include deleted events in the results
>
> #### Payload
>
> **calendar\_id** `string` *required*
>
> The calendar identifier
>
> **end\_time** `string`
>
> Event end time in ISO format
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **organizer\_email** `string`
>
> Email of the event organizer
>
> **organizer\_name** `string`
>
> Name of the event organizer
>
> **start\_time** `string`
>
> Event start time in ISO format
>
> **summary** `string`
>
> Event title/summary

> [accordion] Calendar Event Sync
>
> **Slug:** `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER`
>
> **Type:** poll
>
> Polling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook).
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **showDeleted** `boolean`
>
> Whether to include deleted events in the results
>
> #### Payload
>
> **attendees** `array`
>
> List of attendees
>
> **calendar\_id** `string` *required*
>
> The calendar identifier
>
> **conference\_data** `object`
>
> Conference data structure containing details about the meeting
>
> **created\_at** `string`
>
> When the event was created
>
> **creator\_email** `string`
>
> Email of the event creator
>
> **creator\_name** `string`
>
> Name of the event creator
>
> **description** `string`
>
> Event description
>
> **end\_time** `string`
>
> Event end time in ISO format
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **event\_type** `string` *required*
>
> Type of change: created, updated, or deleted
>
> **hangout\_link** `string`
>
> Google Meet link for the conference, if available
>
> **html\_link** `string`
>
> Link to the event in Google Calendar
>
> **location** `string`
>
> Event location
>
> **organizer\_email** `string`
>
> Email of the event organizer
>
> **organizer\_name** `string`
>
> Name of the event organizer
>
> **recurring\_event\_id** `string`
>
> ID of recurring event if applicable
>
> **start\_time** `string`
>
> Event start time in ISO format
>
> **status** `string`
>
> Event status (confirmed, tentative, cancelled)
>
> **summary** `string`
>
> Event title/summary
>
> **updated\_at** `string`
>
> When the event was last updated
>
> **visibility** `string`
>
> Event visibility

> [accordion] Event Updated
>
> **Slug:** `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER`
>
> **Type:** poll
>
> Triggers when an existing Google Calendar event is modified. Returns the event ID, change type, and the specific fields that changed with their previous and new values.
>
> #### Configuration
>
> **calendarId** `string`
>
> The unique identifier for the calendar
>
> **interval** `number`
>
> Deprecated: use `polling_interval` on the trigger instance instead. Minutes between checks for new events.
>
> **showDeleted** `boolean`
>
> Whether to include deleted (cancelled) events in the results
>
> **tracked\_fields** `array`
>
> List of event fields to track for changes. start and end are compared as RFC3339 strings (preferring dateTime over date). Attendees are compared by email, displayName, responseStatus, and optional flag.
>
> #### Payload
>
> **calendar\_id** `string` *required*
>
> The calendar identifier
>
> **change\_type** `string`
>
> Type of change. Always 'updated' for this trigger
>
> **event\_id** `string` *required*
>
> The unique identifier of the event
>
> **updated\_at** `string`
>
> When the event was last updated (RFC3339)
>
> **updated\_fields** `object` *required*
>
> Dictionary of changed fields with old and new values
