Google Calendar

tools

• GOOGLECALENDAR_ACL_PATCH

  Updates an access control rule for a calendar using patch semantics (partial update). This allows modifying specific fields without affecting other properties. Note: Each patch request consumes three quota units. For domain-type ACL rules, if PATCH fails with 500 error, this action will automatically fallback to UPDATE method.

  in ▸ role scope rule_id calendar_id send_notifications

• GOOGLECALENDAR_CALENDARS_DELETE

  Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.

  in ▸ calendar_id

• GOOGLECALENDAR_CALENDARS_UPDATE

  Updates metadata for a calendar.

  in ▸ summary location timeZone calendarId description

• GOOGLECALENDAR_CALENDAR_LIST_INSERT

  Inserts an existing calendar into the user's calendar list.

  in ▸ id hidden color_id selected background_color color_rgb_format foreground_color summary_override default_reminders notification_settings

• GOOGLECALENDAR_CALENDAR_LIST_UPDATE

  Updates an existing entry on the user\'s calendar list.

  in ▸ hidden colorId selected calendar_id colorRgbFormat backgroundColor foregroundColor summaryOverride defaultReminders notificationSettings

• GOOGLECALENDAR_CLEAR_CALENDAR

  Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.

  in ▸ calendar_id

• GOOGLECALENDAR_CREATE_EVENT

  Create a Google Calendar event using `start_datetime` plus `event_duration_hour` and `event_duration_minutes` fields to derive the end time. Requires calendar write access. The organizer is added as an attendee unless `exclude_organizer` is True. Example request to create event for 1 hour 30 minutes: { "calendar_id": "primary", "start_datetime": "2025-01-16T13:00:00", "timezone": "America/New_York", "event_duration_hour": 1, "event_duration_minutes": 30, "summary": "Client sync", "attendees": [{"email": "guest@example.com"}] }

  in ▸ summary location timezone attendees eventType recurrence visibility calendar_id description send_updates transparency start_datetime exclude_organizer guests_can_modify birthdayProperties create_meeting_room event_duration_hour focusTimeProperties guestsCanInviteOthers outOfOfficeProperties event_duration_minutes guestsCanSeeOtherGuests workingLocationProperties

• GOOGLECALENDAR_DELETE_EVENT

  Deletes a specified event by `event_id` from a Google Calendar (`calendar_id`); this action is idempotent and raises a 404 error if the event is not found.

  in ▸ event_id calendar_id

• GOOGLECALENDAR_DUPLICATE_CALENDAR

  Creates a new, empty Google Calendar with the specified title (summary).

  in ▸ summary

• GOOGLECALENDAR_EVENTS_INSTANCES

  Returns instances of the specified recurring event.

  in ▸ eventId timeMax timeMin timeZone pageToken calendarId maxResults showDeleted maxAttendees originalStart

• GOOGLECALENDAR_EVENTS_LIST

  Returns events on the specified calendar.

  in ▸ q iCalUID orderBy timeMax timeMin timeZone pageToken syncToken calendarId eventTypes maxResults updatedMin showDeleted maxAttendees singleEvents alwaysIncludeEmail showHiddenInvitations sharedExtendedProperty privateExtendedProperty

• GOOGLECALENDAR_EVENTS_MOVE

  Moves an event to another calendar, i.e., changes an event's organizer.

  in ▸ event_id calendar_id destination send_updates

• GOOGLECALENDAR_EVENTS_WATCH

  Watch for changes to Events resources.

  in ▸ id type token params address payload calendarId

• GOOGLECALENDAR_FIND_EVENT

  Finds events in a specified Google Calendar using text query, time ranges (event start/end, last modification), and event types; ensure `timeMin` is not chronologically after `timeMax` if both are provided.

  in ▸ query timeMax timeMin order_by page_token calendar_id event_types max_results updated_min show_deleted single_events

• GOOGLECALENDAR_FIND_FREE_SLOTS

  Finds both free and busy time slots in Google Calendars for specified calendars within a defined time range (defaults to the current day UTC if `time_min`/`time_max` are omitted). Returns busy intervals enriched with event details and calculates free slots by finding gaps between busy periods; `time_min` must precede `time_max` if both are provided. This action retrieves free and busy time slots for the specified calendars over a given time period. It analyzes the busy intervals from the calendars and provides calculated free slots based on the gaps in the busy periods.

  in ▸ items time_max time_min timezone group_expansion_max calendar_expansion_max

• GOOGLECALENDAR_FREE_BUSY_QUERY

  Returns free/busy information for a set of calendars.

  in ▸ items timeMax timeMin timeZone groupExpansionMax calendarExpansionMax

• GOOGLECALENDAR_GET_CALENDAR

  Retrieves a specific Google Calendar, identified by `calendar_id`, to which the authenticated user has access.

  in ▸ calendar_id

• GOOGLECALENDAR_GET_CURRENT_DATE_TIME

  Gets the current date and time, allowing for a specific timezone offset.

  in ▸ timezone

• GOOGLECALENDAR_LIST_ACL_RULES

  Retrieves the list of access control rules (ACLs) for a specified calendar, providing the necessary 'rule_id' values required for updating specific ACL rules.

  in ▸ page_token sync_token calendar_id max_results show_deleted

• GOOGLECALENDAR_LIST_CALENDARS

  Retrieves a paginated list of calendars from the user's calendar list, with optional filtering and sync capabilities.

  in ▸ pageToken syncToken maxResults showHidden showDeleted minAccessRole

• GOOGLECALENDAR_PATCH_CALENDAR

  Partially updates (PATCHes) an existing Google Calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` clears them.

  in ▸ summary location timezone calendar_id description

• GOOGLECALENDAR_PATCH_EVENT

  Update specified fields of an existing event in a Google Calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar_id` and `event_id` are valid and the user has write access to the calendar.

  in ▸ summary end_time event_id location timezone attendees start_time calendar_id description send_updates max_attendees rsvp_response supports_attachments conference_data_version

• GOOGLECALENDAR_QUICK_ADD

  Parses natural language text to quickly create a basic Google Calendar event with its title, date, and time, suitable for simple scheduling; does not support direct attendee addition or recurring events, and `calendar_id` must be valid if not 'primary'.

  in ▸ text calendar_id send_updates

• GOOGLECALENDAR_REMOVE_ATTENDEE

  Removes an attendee from a specified event in a Google Calendar; the calendar and event must exist.

  in ▸ event_id calendar_id attendee_email

• GOOGLECALENDAR_SETTINGS_LIST

  Returns all user settings for the authenticated user.

  in ▸ pageToken syncToken maxResults

• GOOGLECALENDAR_SETTINGS_WATCH

  Watch for changes to Settings resources.

  in ▸ id type token params address

• GOOGLECALENDAR_SYNC_EVENTS

  Synchronizes Google Calendar events, performing a full sync if no `sync_token` is provided or if a 410 GONE error (due to an expired token) necessitates it, otherwise performs an incremental sync for events changed since the `sync_token` was issued.

  in ▸ pageToken sync_token calendar_id event_types max_results single_events

• GOOGLECALENDAR_UPDATE_ACL_RULE

  Updates an access control rule for the specified calendar.

  in ▸ role rule_id calendar_id send_notifications

• GOOGLECALENDAR_UPDATE_EVENT

  Updates an existing event by `event_id` in a Google Calendar; this is a full PUT replacement, so provide all desired fields as unspecified ones may be cleared or reset.

  in ▸ summary event_id location timezone attendees eventType recurrence visibility calendar_id description send_updates transparency start_datetime guests_can_modify birthdayProperties create_meeting_room event_duration_hour focusTimeProperties guestsCanInviteOthers outOfOfficeProperties event_duration_minutes guestsCanSeeOtherGuests workingLocationProperties