> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/google-calendar.md).

# Google Calendar

Google Calendar is a calendar program included as part of Google's free, web-based office suite.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector       | Authentication |
| --------------- | -------------- |
| Google Calendar | OAuth sign-in  |

#### Google Calendar

Connect to Google Calendar to access and manage your schedule. Supports creating, editing, deleting and accessing calendars and events.

**Set up in Google Calendar**

1. Sign in to the Google account whose calendars you want to use.
2. Review and authorize the requested permissions to view and manage your calendars and events.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Google Calendar**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

**Provider documentation:** [Setup reference](https://support.google.com/calendar/answer/2465776).

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Google Calendar** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

#### Add Attendees

Add attendees to an existing Google Calendar event

**Inputs**

| Field            | Type            | Required | Description                                                                                                                                                                                                        |
| ---------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Calendar         | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary.                                                                                    |
| Event            | select (string) | Yes      | Select an event. Options load from the selected connection.                                                                                                                                                        |
| Attendees        | string          | Yes      | Comma-separated email addresses to add.                                                                                                                                                                            |
| Apply To         | select (string) | No       | For recurring events, choose whether to update this occurrence only or the entire series. Entire Series targets the recurring master. Available values: This Event Only, Entire Series. Default: this\_occurrence. |
| Notify Attendees | select (string) | No       | Whether to send email notifications to attendees. Available values: None, All, External Only. Default: none.                                                                                                       |

**Outputs**

| Field           | Type   | Description                               |
| --------------- | ------ | ----------------------------------------- |
| Event ID        | string | The ID of the updated event.              |
| Attendees Added | array  | Email addresses of newly added attendees. |
| Total Attendees | number | Total number of attendees after adding.   |
| Status Message  | string | Summary of the operation.                 |

#### Check Availability

Check busy/free times across one or more Google Calendars

**Inputs**

| Field      | Type                      | Required | Description                                                                                                         |
| ---------- | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| Calendars  | multiple\_select (string) | No       | Select one or more calendars. If omitted, your primary calendar is used. Options load from the selected connection. |
| Start Time | datetime                  | Yes      | Start of the time range to check. Do not include timezone in this field.                                            |
| End Time   | datetime                  | Yes      | End of the time range to check. Do not include timezone in this field.                                              |

**Outputs**

| Field              | Type   | Description                                            |
| ------------------ | ------ | ------------------------------------------------------ |
| Busy Time Slots    | array  | List of all busy time blocks across calendars.         |
| Calendar Details   | array  | Per-calendar breakdown of busy blocks.                 |
| Total Busy Slots   | number | Count of busy time blocks.                             |
| Status Message     | string | Summary of the availability check.                     |
| Effective Timezone | string | Timezone used to interpret the input start/end values. |

#### Create Calendar

Create a new Google Calendar with a specified name

**Inputs**

| Field         | Type   | Required | Description                            |
| ------------- | ------ | -------- | -------------------------------------- |
| Calendar Name | string | Yes      | The name for the new calendar.         |
| Description   | string | No       | Optional description for the calendar. |

**Outputs**

| Field          | Type   | Description                            |
| -------------- | ------ | -------------------------------------- |
| Calendar ID    | string | The unique ID of the created calendar. |
| Status Message | string | Success message with details.          |

#### Create Event

Create a new event in a Google Calendar

**Inputs**

| Field                | Type            | Required | Description                                                                                                                                              |
| -------------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar             | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary.                          |
| Title                | string          | Yes      | The title of the event.                                                                                                                                  |
| All Day Event        | boolean         | No       | Toggle for all-day event. Default: false.                                                                                                                |
| Date                 | date            | No       | The date for the all-day event (required when All Day is enabled).                                                                                       |
| Start Time           | datetime        | No       | The start time (required when All Day is disabled). Do not include timezone in this field.                                                               |
| End Time             | datetime        | No       | The end time (required when All Day is disabled). Do not include timezone in this field.                                                                 |
| Timezone             | select (string) | No       | Timezone for the event. If not selected, we use your Google Calendar default timezone (or calendar timezone). Options load from the selected connection. |
| Description          | textarea        | No       | Description or details about the event.                                                                                                                  |
| Location             | string          | No       | Location where the event will take place.                                                                                                                |
| Attendees            | string          | No       | Comma-separated email addresses.                                                                                                                         |
| Add Google Meet Link | boolean         | No       | Add a Google Meet video call to the event. Default: false.                                                                                               |
| Repeat               | select (string) | No       | How often the event should repeat. Available values: Don't repeat, Daily, Weekly, Monthly, Yearly. Default: Don't repeat.                                |
| Repeat Count         | number          | No       | Number of times to repeat the event. If left empty, a default count is used. Large repeat counts are limited for safety.                                 |
| Notify Attendees     | select (string) | No       | Whether to send email notifications to attendees. Available values: None, All, External Only. Default: none.                                             |

**Outputs**

| Field            | Type   | Description                                |
| ---------------- | ------ | ------------------------------------------ |
| Event ID         | string | The unique ID of the created event.        |
| Event Link       | string | Link to view the event in Google Calendar. |
| Google Meet Link | string | Link to join the Google Meet (if added).   |
| Status Message   | string | Success message with details.              |

#### Delete Calendar

Delete a Google Calendar

**Inputs**

| Field    | Type            | Required | Description                                                                                                                                              |
| -------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar | select (string) | Yes      | Permanent action: this cannot be undone. Primary calendars cannot be deleted. You must be the calendar owner. Options load from the selected connection. |

**Outputs**

| Field          | Type    | Description                          |
| -------------- | ------- | ------------------------------------ |
| Success        | boolean | Whether the deletion was successful. |
| Status Message | string  | Summary of the operation.            |

#### Delete Event

Delete an event from a Google Calendar

**Inputs**

| Field            | Type            | Required | Description                                                                                                                                                                 |
| ---------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar         | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary.                                             |
| Event            | select (string) | Yes      | Permanent action: this event will be deleted and cannot be restored. You must have permission to delete events on this calendar. Options load from the selected connection. |
| Notify Attendees | select (string) | No       | Whether to send email notifications to attendees. Available values: None, All, External Only. Default: none.                                                                |

**Outputs**

| Field          | Type    | Description                          |
| -------------- | ------- | ------------------------------------ |
| Success        | boolean | Whether the deletion was successful. |
| Status Message | string  | Summary of the operation.            |

#### Get Calendar

Get details of a Google Calendar

**Inputs**

| Field    | Type            | Required | Description                                                   |
| -------- | --------------- | -------- | ------------------------------------------------------------- |
| Calendar | select (string) | Yes      | Select a calendar. Options load from the selected connection. |

**Outputs**

| Field          | Type    | Description                            |
| -------------- | ------- | -------------------------------------- |
| Calendar ID    | string  | The unique ID of the calendar.         |
| Name           | string  | The calendar name.                     |
| Description    | string  | The calendar description.              |
| Timezone       | string  | The calendar timezone.                 |
| Access Role    | string  | Your access role for this calendar.    |
| Is Primary     | boolean | Whether this is your primary calendar. |
| Status Message | string  | Summary of the operation.              |

#### Get Event

Get details of a specific Google Calendar event

**Inputs**

| Field    | Type            | Required | Description                                                                                                                     |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Calendar | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary. |
| Event    | select (string) | Yes      | Select an event. Options load from the selected connection.                                                                     |

**Outputs**

| Field            | Type    | Description                                |
| ---------------- | ------- | ------------------------------------------ |
| Event ID         | string  | The unique ID of the event.                |
| Title            | string  | The event title.                           |
| Start Time       | string  | The event start time.                      |
| End Time         | string  | The event end time.                        |
| All Day Event    | boolean | Whether this is an all-day event.          |
| Timezone         | string  | The event timezone.                        |
| Description      | string  | The event description.                     |
| Location         | string  | The event location.                        |
| Attendees        | array   | Email addresses of attendees.              |
| Google Meet Link | string  | Link to join Google Meet.                  |
| Calendar Link    | string  | Link to view the event in Google Calendar. |
| Recurrence Rules | array   | Recurrence rules for the event.            |
| Status Message   | string  | Summary of the operation.                  |

#### List Calendars

List all Google Calendars accessible to you

**Inputs**

No input fields are required in this catalog entry.

**Outputs**

| Field          | Type   | Description                                   |
| -------------- | ------ | --------------------------------------------- |
| Calendars      | array  | List of all calendars accessible to the user. |
| Total Count    | number | Number of calendars found.                    |
| Status Message | string | Summary of the operation.                     |

#### List Events

List upcoming events from a Google Calendar

**Inputs**

| Field    | Type            | Required | Description                                                                                                                     |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Calendar | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary. |

**Outputs**

| Field          | Type   | Description               |
| -------------- | ------ | ------------------------- |
| Events         | array  | List of upcoming events.  |
| Total Count    | number | Number of events found.   |
| Status Message | string | Summary of the operation. |

#### Quick Add Event

Quickly create an event using natural language

**Inputs**

| Field                | Type            | Required | Description                                                                                                                     |
| -------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Calendar             | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary. |
| Event Description    | string          | Yes      | Natural language description of the event.                                                                                      |
| Attendees            | string          | No       | Comma-separated email addresses.                                                                                                |
| Add Google Meet Link | boolean         | No       | Add a Google Meet link to the created event. Default: false.                                                                    |

**Outputs**

| Field            | Type   | Description                                   |
| ---------------- | ------ | --------------------------------------------- |
| Event ID         | string | The unique ID of the created event.           |
| Parsed Title     | string | The title parsed from your description.       |
| Parsed Start     | string | The start time parsed from your description.  |
| Parsed End       | string | The end time parsed from your description.    |
| Event Link       | string | Link to view the event in Google Calendar.    |
| Google Meet Link | string | Link to join Google Meet, if one was created. |
| Status Message   | string | Summary of the operation.                     |

#### Update Event

Update an existing Google Calendar event

**Inputs**

| Field            | Type            | Required | Description                                                                                                                                                           |
| ---------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar         | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary.                                       |
| Event            | select (string) | Yes      | Select the event to update. Options load from the selected connection.                                                                                                |
| Title            | string          | No       | New title for the event (leave empty to keep current).                                                                                                                |
| All Day Event    | boolean         | No       | Change to all-day event (leave empty to keep current).                                                                                                                |
| Date             | date            | No       | New date for all-day event (leave empty to keep current).                                                                                                             |
| Start Time       | datetime        | No       | New start time (leave empty to keep current). Timezone is controlled by the Timezone field. Do not include timezone in this field.                                    |
| End Time         | datetime        | No       | New end time (leave empty to keep current). Timezone is controlled by the Timezone field. Do not include timezone in this field.                                      |
| Timezone         | select (string) | No       | Timezone for the event. If not selected, we use your Google Calendar default timezone (or calendar timezone). Options load from the selected connection.              |
| Description      | string          | No       | New description (leave empty to keep current).                                                                                                                        |
| Location         | string          | No       | New location (leave empty to keep current).                                                                                                                           |
| Repeat           | select (string) | No       | Repeat frequency to apply. Use 'No Change' to keep current setting. Available values: No Change, Don't repeat, Daily, Weekly, Monthly, Yearly. Default: \_\_keep\_\_. |
| Repeat Count     | number          | No       | Number of times to repeat. If left empty, a default count is used. Large repeat counts are limited for safety.                                                        |
| Notify Attendees | select (string) | No       | Whether to send email notifications to attendees. Available values: None, All, External Only. Default: none.                                                          |

**Outputs**

| Field          | Type   | Description                     |
| -------------- | ------ | ------------------------------- |
| Event ID       | string | The ID of the updated event.    |
| Event Link     | string | Link to view the updated event. |
| Status Message | string | Summary of the changes.         |

#### Respond to Event

Respond (RSVP) to a Google Calendar event invitation

**Inputs**

| Field            | Type            | Required | Description                                                                                                                     |
| ---------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Calendar         | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary. |
| Event            | select (string) | Yes      | Select an event. Options load from the selected connection.                                                                     |
| Your Response    | select (string) | Yes      | How you want to respond to this invitation. Available values: Yes (accepted), No (declined), Maybe (tentative).                 |
| Comment          | string          | No       | Optional comment to include with your response.                                                                                 |
| Notify Attendees | select (string) | No       | Whether to send email notifications to attendees. Available values: None, All, External Only. Default: none.                    |

**Outputs**

| Field           | Type   | Description                           |
| --------------- | ------ | ------------------------------------- |
| Event ID        | string | The ID of the event you responded to. |
| Response Status | string | Your recorded response.               |
| Event Link      | string | Link to view the event.               |
| Status Message  | string | Summary of the operation.             |

#### Set Event Color

Set the color label of a Google Calendar event

**Inputs**

| Field    | Type            | Required | Description                                                                                                                                               |
| -------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar | select (string) | No       | Select a calendar. If not selected, your primary calendar is used. Options load from the selected connection. Default: primary.                           |
| Event    | select (string) | Yes      | Select an event. Options load from the selected connection.                                                                                               |
| Color    | select (string) | Yes      | The color label to apply to the event. Available values: Lavender, Sage, Grape, Flamingo, Banana, Tangerine, Peacock, Graphite, Blueberry, Basil, Tomato. |

**Outputs**

| Field          | Type   | Description                            |
| -------------- | ------ | -------------------------------------- |
| Event ID       | string | The ID of the updated event.           |
| Color ID       | string | The color ID applied to the event.     |
| Color Name     | string | The display name of the applied color. |
| Event Link     | string | Link to view the updated event.        |
| Status Message | string | Summary of the operation.              |

### Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

#### On Event Created

Start this workflow whenever a new event is created on your calendar.

**Required permissions:** `https://www.googleapis.com/auth/calendar.events.readonly`.

**Configuration**

| Field             | Type            | Required | Description                                                                                                                                                                                                                      |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar          | select (string) | Yes      | The calendar to monitor for events. Options load from the selected connection. Default: primary.                                                                                                                                 |
| Filter by keyword | string          | No       | Only trigger for events whose title contains this text. Leave blank to trigger on all events.                                                                                                                                    |
| Check Frequency   | select (string) | No       | How often to check for calendar events. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes.                                                             |
| Timezone          | select (string) | No       | Timezone for the polling schedule. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |

**Event inputs**

| Field       | Type    | Required | Description                                                           |
| ----------- | ------- | -------- | --------------------------------------------------------------------- |
| Event ID    | string  | Yes      | The unique Google Calendar event ID.                                  |
| Title       | string  | Yes      | The title (summary) of the event.                                     |
| Start       | string  | Yes      | The start date/time of the event.                                     |
| End         | string  | Yes      | The end date/time of the event.                                       |
| Description | string  | No       | The description of the event. Default: .                              |
| Location    | string  | No       | The location of the event. Default: .                                 |
| Status      | string  | No       | The status of the event (confirmed, tentative, cancelled). Default: . |
| Event Link  | string  | No       | A link to view the event in Google Calendar. Default: .               |
| Attendees   | string  | No       | Comma-separated list of attendee email addresses. Default: .          |
| All Day     | boolean | No       | Whether the event is an all-day event. Default: false.                |
| Calendar ID | string  | No       | The calendar ID where this event belongs. Default: .                  |
| Created     | string  | No       | When the event was created (ISO 8601). Default: .                     |
| Updated     | string  | No       | When the event was last updated (ISO 8601). Default: .                |

**Outputs**

| Field       | Type    | Description                                       |
| ----------- | ------- | ------------------------------------------------- |
| Event ID    | string  | The unique Google Calendar event ID.              |
| Title       | string  | The title (summary) of the event.                 |
| Start       | string  | The start date/time of the event.                 |
| End         | string  | The end date/time of the event.                   |
| Description | string  | The description of the event.                     |
| Location    | string  | The location of the event.                        |
| Status      | string  | The status of the event.                          |
| Event Link  | string  | A link to view the event in Google Calendar.      |
| Attendees   | string  | Comma-separated list of attendee email addresses. |
| All Day     | boolean | Whether the event is an all-day event.            |
| Calendar ID | string  | The calendar ID where this event belongs.         |
| Created     | string  | When the event was created.                       |
| Updated     | string  | When the event was last updated.                  |

#### On Event Updated

Start this workflow whenever a calendar event is modified.

**Required permissions:** `https://www.googleapis.com/auth/calendar.events.readonly`.

**Configuration**

| Field             | Type            | Required | Description                                                                                                                                                                                                                      |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar          | select (string) | Yes      | The calendar to monitor for events. Options load from the selected connection. Default: primary.                                                                                                                                 |
| Filter by keyword | string          | No       | Only trigger for events whose title contains this text. Leave blank to trigger on all events.                                                                                                                                    |
| Check Frequency   | select (string) | No       | How often to check for calendar events. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes.                                                             |
| Timezone          | select (string) | No       | Timezone for the polling schedule. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |

**Event inputs**

| Field       | Type    | Required | Description                                                           |
| ----------- | ------- | -------- | --------------------------------------------------------------------- |
| Event ID    | string  | Yes      | The unique Google Calendar event ID.                                  |
| Title       | string  | Yes      | The title (summary) of the event.                                     |
| Start       | string  | Yes      | The start date/time of the event.                                     |
| End         | string  | Yes      | The end date/time of the event.                                       |
| Description | string  | No       | The description of the event. Default: .                              |
| Location    | string  | No       | The location of the event. Default: .                                 |
| Status      | string  | No       | The status of the event (confirmed, tentative, cancelled). Default: . |
| Event Link  | string  | No       | A link to view the event in Google Calendar. Default: .               |
| Attendees   | string  | No       | Comma-separated list of attendee email addresses. Default: .          |
| All Day     | boolean | No       | Whether the event is an all-day event. Default: false.                |
| Calendar ID | string  | No       | The calendar ID where this event belongs. Default: .                  |
| Created     | string  | No       | When the event was created (ISO 8601). Default: .                     |
| Updated     | string  | No       | When the event was last updated (ISO 8601). Default: .                |

**Outputs**

| Field       | Type    | Description                                       |
| ----------- | ------- | ------------------------------------------------- |
| Event ID    | string  | The unique Google Calendar event ID.              |
| Title       | string  | The title (summary) of the event.                 |
| Start       | string  | The start date/time of the event.                 |
| End         | string  | The end date/time of the event.                   |
| Description | string  | The description of the event.                     |
| Location    | string  | The location of the event.                        |
| Status      | string  | The status of the event.                          |
| Event Link  | string  | A link to view the event in Google Calendar.      |
| Attendees   | string  | Comma-separated list of attendee email addresses. |
| All Day     | boolean | Whether the event is an all-day event.            |
| Calendar ID | string  | The calendar ID where this event belongs.         |
| Created     | string  | When the event was created.                       |
| Updated     | string  | When the event was last updated.                  |

#### On Event Cancelled

Start this workflow whenever a calendar event is cancelled or deleted.

**Required permissions:** `https://www.googleapis.com/auth/calendar.events.readonly`.

**Configuration**

| Field             | Type            | Required | Description                                                                                                                                                                                                                      |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar          | select (string) | Yes      | The calendar to monitor for events. Options load from the selected connection. Default: primary.                                                                                                                                 |
| Filter by keyword | string          | No       | Only trigger for events whose title contains this text. Leave blank to trigger on all events.                                                                                                                                    |
| Check Frequency   | select (string) | No       | How often to check for calendar events. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes.                                                             |
| Timezone          | select (string) | No       | Timezone for the polling schedule. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |

**Event inputs**

| Field       | Type    | Required | Description                                                           |
| ----------- | ------- | -------- | --------------------------------------------------------------------- |
| Event ID    | string  | Yes      | The unique Google Calendar event ID.                                  |
| Title       | string  | Yes      | The title (summary) of the event.                                     |
| Start       | string  | Yes      | The start date/time of the event.                                     |
| End         | string  | Yes      | The end date/time of the event.                                       |
| Description | string  | No       | The description of the event. Default: .                              |
| Location    | string  | No       | The location of the event. Default: .                                 |
| Status      | string  | No       | The status of the event (confirmed, tentative, cancelled). Default: . |
| Event Link  | string  | No       | A link to view the event in Google Calendar. Default: .               |
| Attendees   | string  | No       | Comma-separated list of attendee email addresses. Default: .          |
| All Day     | boolean | No       | Whether the event is an all-day event. Default: false.                |
| Calendar ID | string  | No       | The calendar ID where this event belongs. Default: .                  |
| Created     | string  | No       | When the event was created (ISO 8601). Default: .                     |
| Updated     | string  | No       | When the event was last updated (ISO 8601). Default: .                |

**Outputs**

| Field       | Type    | Description                                       |
| ----------- | ------- | ------------------------------------------------- |
| Event ID    | string  | The unique Google Calendar event ID.              |
| Title       | string  | The title (summary) of the event.                 |
| Start       | string  | The start date/time of the event.                 |
| End         | string  | The end date/time of the event.                   |
| Description | string  | The description of the event.                     |
| Location    | string  | The location of the event.                        |
| Status      | string  | The status of the event.                          |
| Event Link  | string  | A link to view the event in Google Calendar.      |
| Attendees   | string  | Comma-separated list of attendee email addresses. |
| All Day     | boolean | Whether the event is an all-day event.            |
| Calendar ID | string  | The calendar ID where this event belongs.         |
| Created     | string  | When the event was created.                       |
| Updated     | string  | When the event was last updated.                  |

#### On Event Started

Start this workflow whenever a calendar event begins.

**Required permissions:** `https://www.googleapis.com/auth/calendar.events.readonly`.

**Configuration**

| Field             | Type            | Required | Description                                                                                                                                                                                                                      |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar          | select (string) | Yes      | The calendar to monitor for events. Options load from the selected connection. Default: primary.                                                                                                                                 |
| Filter by keyword | string          | No       | Only trigger for events whose title contains this text. Leave blank to trigger on all events.                                                                                                                                    |
| Check Frequency   | select (string) | No       | How often to check for calendar events. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes.                                                             |
| Timezone          | select (string) | No       | Timezone for the polling schedule. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |

**Event inputs**

| Field       | Type    | Required | Description                                                           |
| ----------- | ------- | -------- | --------------------------------------------------------------------- |
| Event ID    | string  | Yes      | The unique Google Calendar event ID.                                  |
| Title       | string  | Yes      | The title (summary) of the event.                                     |
| Start       | string  | Yes      | The start date/time of the event.                                     |
| End         | string  | Yes      | The end date/time of the event.                                       |
| Description | string  | No       | The description of the event. Default: .                              |
| Location    | string  | No       | The location of the event. Default: .                                 |
| Status      | string  | No       | The status of the event (confirmed, tentative, cancelled). Default: . |
| Event Link  | string  | No       | A link to view the event in Google Calendar. Default: .               |
| Attendees   | string  | No       | Comma-separated list of attendee email addresses. Default: .          |
| All Day     | boolean | No       | Whether the event is an all-day event. Default: false.                |
| Calendar ID | string  | No       | The calendar ID where this event belongs. Default: .                  |
| Created     | string  | No       | When the event was created (ISO 8601). Default: .                     |
| Updated     | string  | No       | When the event was last updated (ISO 8601). Default: .                |

**Outputs**

| Field       | Type    | Description                                       |
| ----------- | ------- | ------------------------------------------------- |
| Event ID    | string  | The unique Google Calendar event ID.              |
| Title       | string  | The title (summary) of the event.                 |
| Start       | string  | The start date/time of the event.                 |
| End         | string  | The end date/time of the event.                   |
| Description | string  | The description of the event.                     |
| Location    | string  | The location of the event.                        |
| Status      | string  | The status of the event.                          |
| Event Link  | string  | A link to view the event in Google Calendar.      |
| Attendees   | string  | Comma-separated list of attendee email addresses. |
| All Day     | boolean | Whether the event is an all-day event.            |
| Calendar ID | string  | The calendar ID where this event belongs.         |
| Created     | string  | When the event was created.                       |
| Updated     | string  | When the event was last updated.                  |

#### On Event Ended

Start this workflow whenever a calendar event finishes.

**Required permissions:** `https://www.googleapis.com/auth/calendar.events.readonly`.

**Configuration**

| Field             | Type            | Required | Description                                                                                                                                                                                                                      |
| ----------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Calendar          | select (string) | Yes      | The calendar to monitor for events. Options load from the selected connection. Default: primary.                                                                                                                                 |
| Filter by keyword | string          | No       | Only trigger for events whose title contains this text. Leave blank to trigger on all events.                                                                                                                                    |
| Check Frequency   | select (string) | No       | How often to check for calendar events. Available values: Every minute, Every 5 minutes, Every 15 minutes, Every 30 minutes, Every hour. Default: every\_5\_minutes.                                                             |
| Timezone          | select (string) | No       | Timezone for the polling schedule. Available values: PACIFIC TIME, MOUNTAIN TIME, CENTRAL TIME, EASTERN TIME, ATLANTIC TIME, UTC, LONDON, PARIS, BERLIN, MOSCOW, DUBAI, INDIA, SINGAPORE, TOKYO, SYDNEY, AUCKLAND. Default: UTC. |

**Event inputs**

| Field       | Type    | Required | Description                                                           |
| ----------- | ------- | -------- | --------------------------------------------------------------------- |
| Event ID    | string  | Yes      | The unique Google Calendar event ID.                                  |
| Title       | string  | Yes      | The title (summary) of the event.                                     |
| Start       | string  | Yes      | The start date/time of the event.                                     |
| End         | string  | Yes      | The end date/time of the event.                                       |
| Description | string  | No       | The description of the event. Default: .                              |
| Location    | string  | No       | The location of the event. Default: .                                 |
| Status      | string  | No       | The status of the event (confirmed, tentative, cancelled). Default: . |
| Event Link  | string  | No       | A link to view the event in Google Calendar. Default: .               |
| Attendees   | string  | No       | Comma-separated list of attendee email addresses. Default: .          |
| All Day     | boolean | No       | Whether the event is an all-day event. Default: false.                |
| Calendar ID | string  | No       | The calendar ID where this event belongs. Default: .                  |
| Created     | string  | No       | When the event was created (ISO 8601). Default: .                     |
| Updated     | string  | No       | When the event was last updated (ISO 8601). Default: .                |

**Outputs**

| Field       | Type    | Description                                       |
| ----------- | ------- | ------------------------------------------------- |
| Event ID    | string  | The unique Google Calendar event ID.              |
| Title       | string  | The title (summary) of the event.                 |
| Start       | string  | The start date/time of the event.                 |
| End         | string  | The end date/time of the event.                   |
| Description | string  | The description of the event.                     |
| Location    | string  | The location of the event.                        |
| Status      | string  | The status of the event.                          |
| Event Link  | string  | A link to view the event in Google Calendar.      |
| Attendees   | string  | Comma-separated list of attendee email addresses. |
| All Day     | boolean | Whether the event is an all-day event.            |
| Calendar ID | string  | The calendar ID where this event belongs.         |
| Created     | string  | When the event was created.                       |
| Updated     | string  | When the event was last updated.                  |

### Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/google-calendar.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
