- Category: scheduling & booking
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 50
- Triggers: 7
- Slug:
GOOGLECALENDAR - Version: 20261103_00
Frequently Asked Questions
How do I set up custom Google OAuth credentials for Google Calendar?
How do I set up custom Google OAuth credentials for Google Calendar?
Why am I seeing "App is blocked" when connecting Google Calendar?
Why am I seeing "App is blocked" when connecting Google Calendar?
Why am I getting "Google Calendar API has not been used in project" error?
Why am I getting "Google Calendar API has not been used in project" error?
Why am I getting "Error 400: invalid_scope"?
Why am I getting "Error 400: invalid_scope"?
Why does the OAuth consent screen show "Composio" instead of my app?
Why does the OAuth consent screen show "Composio" instead of my app?
Why am I getting 401 errors on tool calls?
Why am I getting 401 errors on tool calls?
Tools
Delete ACL Rule
Delete ACL Rule
GOOGLECALENDAR_ACL_DELETEDeletes an access control rule from a Google Calendar. Use when you need to remove sharing permissions for a user, group, or domain.Input Parameters
Output
Get ACL Rule
Get ACL Rule
GOOGLECALENDAR_ACL_GETRetrieves a specific access control rule for a calendar. Use when you need to check permissions for a specific user, group, or domain.Input Parameters
Output
Create ACL Rule
Create ACL Rule
GOOGLECALENDAR_ACL_INSERTCreates an access control rule for a calendar. Use when you need to grant sharing permissions to a user, group, or domain.Input Parameters
Output
List ACL Rules
List ACL Rules
GOOGLECALENDAR_ACL_LISTRetrieves 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
Output
Patch ACL Rule
Patch ACL Rule
GOOGLECALENDAR_ACL_PATCHPartially 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
type (one of: ‘user’, ‘group’, ‘domain’, ‘default’) and value (email address or domain name) for all types except ‘default’.Output
Update ACL Rule
Update ACL Rule
GOOGLECALENDAR_ACL_UPDATEUpdates an access control rule for the specified calendar.Input Parameters
Output
Watch ACL Changes
Watch ACL Changes
GOOGLECALENDAR_ACL_WATCHTool 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
Output
Batch Events
Batch Events
GOOGLECALENDAR_BATCH_EVENTSExecute up to 1000 event mutations (create/patch/delete) in one Google Calendar HTTP batch request with per-item status/results. Use this to materially reduce round-trips for bulk operations like migrations, cleanup, or large-scale updates.Input Parameters
Output
Remove Calendar from List
Remove Calendar from List
GOOGLECALENDAR_CALENDAR_LIST_DELETERemoves a calendar from the user’s calendar list, unsubscribing from it without deleting the calendar itself.Input Parameters
Output
Get Single Calendar by ID
Get Single Calendar by ID
GOOGLECALENDAR_CALENDAR_LIST_GETRetrieves 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
Output
Insert Calendar into List
Insert Calendar into List
GOOGLECALENDAR_CALENDAR_LIST_INSERTInserts 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
Output
Patch Calendar List Entry
Patch Calendar List Entry
GOOGLECALENDAR_CALENDAR_LIST_PATCHUpdates an existing calendar on the user’s calendar list using patch semantics. This method allows partial updates, modifying only the specified fields.Input Parameters
Output
Update Calendar List Entry
Update Calendar List Entry
GOOGLECALENDAR_CALENDAR_LIST_UPDATEUpdates 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
Output
Watch Calendar List
Watch Calendar List
GOOGLECALENDAR_CALENDAR_LIST_WATCHCreates 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
Output
Delete Calendar
Delete Calendar
GOOGLECALENDAR_CALENDARS_DELETEDeletes 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
Output
Update Calendar
Update Calendar
GOOGLECALENDAR_CALENDARS_UPDATEFull 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
Output
Stop Channel
Stop Channel
GOOGLECALENDAR_CHANNELS_STOPTool to stop watching resources through a notification channel. Use when you need to discontinue push notifications for a specific channel subscription.Input Parameters
Output
Clear Calendar
Clear Calendar
GOOGLECALENDAR_CLEAR_CALENDARClears a primary calendar by deleting all events from it. The calendar itself is preserved; only its events are removed. Primary calendars cannot be deleted entirely.Input Parameters
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
Get Color Definitions
Get Color Definitions
Create a new calendar
Create a new calendar
GOOGLECALENDAR_CREATE_CALENDARCreates a new secondary Google Calendar with the specified title and optional settings. Use this action when you need to create a new calendar for organizing events separately from the primary calendar. The authenticated user becomes the owner of the newly created calendar. Optional parameters include description, location, and timezone.Input Parameters
Output
Create Event
Create Event
GOOGLECALENDAR_CREATE_EVENTCreates 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
timezone, or UTC when it is omitted.Output
Delete event
Delete event
GOOGLECALENDAR_DELETE_EVENTDeletes an event from the specified calendar. Only Google’s HTTP 204 confirms deletion; 404 or 410 can also mean the event belongs to a different calendar. Bulk deletions may trigger rateLimitExceeded or userRateLimitExceeded; cap concurrency to 5–10 requests and apply exponential backoff.Input Parameters
Output
Create a calendar
Create a calendar
GOOGLECALENDAR_DUPLICATE_CALENDARCreates a new, empty Google Calendar with the specified title (summary). Newly created calendars default to UTC timezone; use GOOGLECALENDAR_PATCH_CALENDAR afterward to set the desired timeZone if needed.Input Parameters
Output
Get Event
Get Event
GOOGLECALENDAR_EVENTS_GETRetrieves 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
Output
Import Event
Import Event
GOOGLECALENDAR_EVENTS_IMPORTTool 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
dateTime must be ISO 8601 format (e.g., '2024-01-15T10:00:00'); timeZone should match the calendar’s timezone to avoid shifted times.'RRULE:FREQ=WEEKLY;BYDAY=MO'); omitting the prefix causes a 400 error.Output
Get Event Instances
Get Event Instances
GOOGLECALENDAR_EVENTS_INSTANCESReturns instances of the specified recurring event. Use timeMin/timeMax to constrain the window; omitting bounds can return large result sets and is quota-heavy. On high-volume calls, 403 rateLimitExceeded or 429 too_many_requests may occur; apply exponential backoff (1s, 2s, 4s) before retrying.Input Parameters
calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the “primary” keyword.singleEvents is False. Optional. The default is False.Output
List Events
List Events
GOOGLECALENDAR_EVENTS_LISTLists 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
Output
List Events from All Calendars
List Events from All Calendars
GOOGLECALENDAR_EVENTS_LIST_ALL_CALENDARSLists 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
nextPageToken in the response until absent to retrieve the complete event list.Output
Move Event
Move Event
GOOGLECALENDAR_EVENTS_MOVEMoves a default event to another calendar, changing its organizer. Other event types cannot be moved.Input Parameters
Output
Watch Events
Watch Events
GOOGLECALENDAR_EVENTS_WATCHWatch for changes to Events resources. Watch channels expire; persist the channel id per calendarId to re-establish watches after expiration or restarts.Input Parameters
Output
Find event
Find event
GOOGLECALENDAR_FIND_EVENTFinds 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
nextPageToken to fetch the subsequent page of results. Always follow every nextPageToken until absent; skipping pagination silently omits events on busy calendars.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’)Output
Find free slots
Find free slots
GOOGLECALENDAR_FIND_FREE_SLOTSQueries 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 or inaccessible are treated as free (not unknown), which can silently produce incorrect availability results.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.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.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.Output
Query Calendar Availability
Query Calendar Availability
GOOGLECALENDAR_FREE_BUSY_QUERYQueries 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
Output
Get Google Calendar
Get Google Calendar
GOOGLECALENDAR_GET_CALENDARGets canonical metadata for one Google Calendar, defaulting to the authenticated user’s primary calendar. Returns its identifier, title, description, location, time zone, and conference properties. 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
Output
Get Calendar Profile (Deprecated)
Get Calendar Profile (Deprecated)
Get current date and time
Get current date and time
GOOGLECALENDAR_GET_CURRENT_DATE_TIMEGets the current date and time, allowing for a specific timezone offset. Call this tool first before computing relative dates (e.g., ‘tomorrow’, ‘next Monday’) to avoid off-by-one-day errors across timezones.Input Parameters
Output
Get Current Google Calendar User
Get Current Google Calendar User
GOOGLECALENDAR_GET_CURRENT_USERIdentifies the Google user connected to Calendar from the primary calendar resource. Returns the account identifier, email when available, display name, timezone, and primary calendar ID. This is Calendar identity metadata, not a full Google Account or People profile.Output
List Buildings
List Buildings
GOOGLECALENDAR_LIST_BUILDINGSLists 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
Output
List Calendar Resources
List Calendar Resources
GOOGLECALENDAR_LIST_CALENDAR_RESOURCESRetrieves calendar resources (such as conference rooms) from a Google Workspace domain using the Admin SDK Directory API. Use this action when you need to list available meeting rooms, conference 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
Output
List Google Calendars
List Google Calendars
GOOGLECALENDAR_LIST_CALENDARSLists calendars accessible through the connected user’s CalendarList, returning IDs and user-specific metadata such as access role, color, visibility, selection, and reminders. Hidden calendars are 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
Output
List Calendar Settings (Deprecated)
List Calendar Settings (Deprecated)
Patch Calendar
Patch Calendar
GOOGLECALENDAR_PATCH_CALENDARPartially updates (PATCHes) an existing Google Calendar, modifying only the fields provided. At least one of summary, description, location, or timezone must be provided. Empty strings for description or location clear them.Input Parameters
Output
Patch Event
Patch Event
GOOGLECALENDAR_PATCH_EVENTUpdate specified fields of an existing event in a Google Calendar using patch semantics (array fields like attendees are fully replaced if provided); ensure the calendar_id and event_id are valid and the user has write access to the calendar.Input Parameters
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.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.calendarList.list method. Must be provided in snake_case format.create_meeting_room=true to create one.Output
Quick Add Event
Quick Add Event
GOOGLECALENDAR_QUICK_ADDParses 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
Output
Remove attendee from event
Remove attendee from event
GOOGLECALENDAR_REMOVE_ATTENDEERemoves 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
Output
Get Calendar Setting
Get Calendar Setting
GOOGLECALENDAR_SETTINGS_GETTool to return a single user setting for the authenticated user. Use when you need to retrieve a specific calendar setting value.Input Parameters
Output
List Settings
List Settings
GOOGLECALENDAR_SETTINGS_LISTLists 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
Output
Watch Settings
Watch Settings
GOOGLECALENDAR_SETTINGS_WATCHWatch for changes to Settings resources.Input Parameters
Output
Sync Events (Deprecated)
Sync Events (Deprecated)
GOOGLECALENDAR_SYNC_EVENTSDeprecated: 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
nextPageToken. Repeat with each returned nextPageToken until no nextPageToken is returned; stopping early silently omits remaining events.timeMin, timeMax, orderBy, query, or updatedMin; mixing these causes the request to fail.Output
Update Google event
Update Google event
GOOGLECALENDAR_UPDATE_EVENTReplaces 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
timezone, or UTC when it is omitted.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’.Output
Triggers
Attendee Response Changed
Attendee Response Changed
GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGERType: pollPolling trigger that fires when any attendee’s RSVP changes to accepted, declined, or tentative. Returns attendee info and current status.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Event Canceled or Deleted
Event Canceled or Deleted
GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGERType: pollTriggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event_id, summary (if available), and cancellation timestamp.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Event Starting Soon
Event Starting Soon
GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGERType: pollTriggers 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
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Calendar Event Changes
Calendar Event Changes
GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGERType: webhookSOON 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
Payload
Event Created
Event Created
GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGERType: pollPolling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info.Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Calendar Event Sync
Calendar Event Sync
GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGERType: pollPolling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook).Configuration
polling_interval on the trigger instance instead. Minutes between checks for new events.Payload
Event Updated
Event Updated
GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGERType: pollTriggers 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
polling_interval on the trigger instance instead. Minutes between checks for new events.