Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

Last updated

Was this helpful?