← Back to all apps

Google Calendar

Productivityby OpenAI
Open in ChatGPTWebsite

Look up events and availability

8ChatGPT Tools
OpenAIDeveloper
ProductivityCategory

Available Tools

Batch Read Event

batch_read_event
Full Description

Read multiple Google Calendar events by ID.

Parameters (1 required, 1 optional)
Required
event_idsarray
Optional
calendar_idstring

Calendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.

Default: null

Create Event

create_event
Full Description

Create a new Google Calendar event and return its details.

Parameters (4 required, 7 optional)
Required
attendeesarray

List of attendee emails. Add `me` to include the authenticated user.

end_timestring

Event end datetime in full ISO-8601/RFC3339 format (e.g. 2026-05-01T10:00:00-07:00).

start_timestring

Event start datetime in full ISO-8601/RFC3339 format (e.g. 2026-05-01T09:00:00-07:00).

titlestring
Optional
auto_decline_modestring

Auto-decline behavior for status events

Default: null
chat_statusstring

Chat status for focus time events

Default: null
decline_messagestring

Optional message sent when declining

Default: null
descriptionstring

Description of the event

Default: null
event_typestring

Optional event type. Use `outOfOffice` or `focusTime` for status events. For `outOfOffice`, Google Calendar rejects events with attendees.

Default: null
locationstring

Location of the event

Default: null
timezone_strstring

IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.

Default: null

Delete Event

delete_event
Full Description

Remove a Google Calendar event.

Parameters (1 required)
Required
event_idstring

Fetch

fetch
Full Description

Get details for a single Google Calendar event.

Parameters (1 required)
Required
event_idstring

Get Profile

get_profile
Full Description

Return the current Google Calendar user's profile information.

This action takes no parameters.

Read Event

read_event
Full Description

Read a Google Calendar event by ID.

Parameters (1 required, 1 optional)
Required
event_idstring

Google Calendar event ID, typically from search results.

Optional
calendar_idstring

Calendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.

Default: null

Read Event All Fields

read_event_all_fields
Full Description

Read a Google Calendar event with extended Google metadata by ID.

Parameters (1 required, 1 optional)
Required
event_idstring

Google Calendar event ID, typically from search results.

Optional
calendar_idstring

Calendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.

Default: null

Respond Event

respond_event
Full Description

Respond to a Google Calendar event invitation.

Parameters (2 required, 2 optional)
Required
event_idstring
response_statusstring

Your response to the event invitation

Options:accepteddeclinedtentative
Optional
notifyboolean

Notify attendees of this response

Default: False
reasonstring

Optional note explaining your response

Default: null

Search

search
Full Description

Search Google Calendar events within an optional time window.

Accepted parameters are only query, max_results, time_min, and time_max. Do not pass unsupported fields like topn, timezone_str, calendar_id, user_message, or best_effort_fetch.

Parameters (1 required, 3 optional)
Required
querystring

Free-text keyword query over events on the primary calendar.

Optional
max_resultsinteger

Maximum number of events to return. Must be at least 1.

Default: 50
time_maxstring

Optional window end in full ISO-8601/RFC3339 format (e.g. 2026-05-31T23:59:59Z).

Default: null
time_minstring

Optional window start in full ISO-8601/RFC3339 format (e.g. 2026-05-01T00:00:00Z).

Default: null

Search Events

search_events
Full Description

Look up Google Calendar events using various filters.

Parameters (0 required, 7 optional)
Optional
calendar_idstring

Calendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.

Default: null
max_resultsinteger

Maximum number of events to return. Must be at least 1.

Default: 50
next_page_tokenstring

Pagination token returned by a previous search_events/search_events_all_fields call. Omit on the first page.

Default: null
querystring
Default: null
time_maxstring

End of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-31T23:59:59Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.

Default: null
time_minstring

Start of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-01T00:00:00Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.

Default: null
timezone_strstring

Timezone for interpreting time_min/time_max. IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.

Default: null

Search Events All Fields

search_events_all_fields
Full Description

Look up Google Calendar events with extended Google metadata.

Parameters (0 required, 7 optional)
Optional
calendar_idstring

Calendar ID to query. Use `primary` for the user's main calendar, or an email-like calendar ID containing `@` (for example `team@group.calendar.google.com`). Default is `primary`.

Default: null
max_resultsinteger

Maximum number of events to return. Must be at least 1.

Default: 50
next_page_tokenstring

Pagination token returned by a previous search_events/search_events_all_fields call. Omit on the first page.

Default: null
querystring
Default: null
time_maxstring

End of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-31T23:59:59Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.

Default: null
time_minstring

Start of the time window. Use full ISO-8601/RFC3339 datetime (for example `2026-05-01T00:00:00Z`) or exact `now`. Do not use relative expressions like `now-7d` or `now+30m`.

Default: null
timezone_strstring

Timezone for interpreting time_min/time_max. IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Default is `America/Los_Angeles`.

Default: null

Update Event

update_event
Full Description

Update an existing Google Calendar event.

Parameters (1 required, 11 optional)
Required
event_idstring

Google Calendar event ID, typically from search results.

Optional
attendeesarray

List of emails of the attendees. Add 'me' to add the current user as an attendee. Leave null or empty to keep the same attendees.

Default: null
auto_decline_modestring

Auto-decline behavior for status events

Default: null
chat_statusstring

Chat status for focus time events

Default: null
decline_messagestring

Optional message sent when declining

Default: null
descriptionstring

Description of the event. Leave null to keep the same description.

Default: null
end_timestring

New end datetime in full ISO-8601/RFC3339 format. Leave null to keep the same end time.

Default: null
event_typestring

Type for status events (`focusTime`/`outOfOffice`). Google Calendar does not allow changing an existing event's eventType.

Default: null
locationstring

Location of the event. Leave null to keep the same location.

Default: null
start_timestring

New start datetime in full ISO-8601/RFC3339 format. Leave null to keep the same start time.

Default: null
timezone_strstring

IANA timezone name such as `America/Los_Angeles` or `Europe/Berlin`. Do not pass UTC offsets like `+02:00`. Provide this whenever changing start_time and/or end_time.

Default: null
titlestring

Title of the event. Leave null to keep the same title.

Default: null

Links

WebsitePrivacy Policy