Skip to main content

​
Overview

Google Calendar lets you organize your schedule and share events with co-workers. Through Langdock’s integration, you can access and manage Google Calendar directly from your conversations.
Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

​
Available Actions

​
Add event

google_calendar.add_event
Creates a new event in a specific calendar Requires Confirmation: Yes Parameters:
  • title (TEXT, Required): Title of the event
  • calendarId (ID, Required): The id of the calendar (e.g. ‘primary’ for the main calendar)
  • startTime (TEXT, Required): Start time in RFC3339 format (e.g. ‘2025-03-15T09:00:00+01:00’)
  • endTime (TEXT, Required): End time in RFC3339 format (e.g. ‘2025-03-15T10:00:00+01:00’)
  • timeZone (TEXT, Required): IMPORTANT: If you don’t know the time zone of the user, ask him. DO NOT GUESS THE TIME ZONE (Example fromat:. ‘America/New_York’)
  • description (TEXT, Optional): Description of the event (optional)
  • location (TEXT, Optional): Location of the event (optional)
  • attendees (TEXT, Optional): List of attendees email adresses (optional)
  • recurrence (TEXT, Optional): List of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Note that DTSTART and DTEND lines are not allowed. The separator between rules is an empty space.
  • sendUpdates (TEXT, Optional): Whether to send notifications (‘all’, ‘externalOnly’, ‘none’)
  • eventType (TEXT, Optional): The type of event. Allowed values: default, focusTime, outOfOffice, workingLocation, etc. See Google Calendar API docs for full list. Provide one event type only
  • createMeetingLink (BOOLEAN, Optional): Whether to create a Google Meet link for this event
Output: Returns the operation result

​
Update event

google_calendar.update_event
Updates an event Requires Confirmation: Yes Parameters:
  • eventId (ID, Required): id of the event
  • endTime (TEXT, Optional): End time in RFC3339 format (e.g. ‘2025-03-15T10:00:00+01:00’)
  • startTime (TEXT, Optional): New start time in RFC3339 format (e.g. ‘2025-03-15T09:00:00+01:00’)
  • calendarId (ID, Required): The id of the calendar (e.g. ‘primary’ for the main calendar)
  • timeZone (TEXT, Optional): New time zone (e.g. ‘America/New_York’)
  • eventTitle (TEXT, Optional): New title of the event (optional)
  • attendees (TEXT, Optional): New list of attendees email adresses (optional)
  • description (TEXT, Optional): New description of the event (optional)
  • location (TEXT, Optional): New location of the event (optional)
  • sendUpdates (TEXT, Optional): New policy on whether to send notifications (‘all’, ‘externalOnly’, ‘none’) (optional)
  • recurrence (TEXT, Optional): New list of RRULE, EXRULE, RDATE and EXDATE lines for a recurring event, as specified in RFC5545. Note that DTSTART and DTEND lines are not allowed. The separator between rules is an empty space.
  • eventType (TEXT, Optional): The type of event to update. Allowed values: default, focusTime, outOfOffice, workingLocation, etc. See Google Calendar API docs for full list. Provide as comma separated list.
Output: Returns the operation result

​
Get event

google_calendar.get_event
Gets an event Requires Confirmation: No Parameters:
  • eventId (ID, Required): The id of the specific event to retrieve
  • calendarId (ID, Required): The id of the calendar (can use ‘primary’ for the user’s primary calendar)
Output: Returns the operation result

​
Search for events

google_calendar.search_for_events
Gets calendar events by search query Requires Confirmation: No Parameters:
  • calendarId (ID, Required): The id of the calendar to search (use ‘primary’ for user’s primary calendar)
  • searchQuery (TEXT, Optional): When using the search field for calendar events, input specific and relevant keywords that are likely to appear in the following fields: IMPORTANT DO NOT IGNORE: if asked to search things like an appointment, meeting, call, … do not include this term into the search query as these are synonyms …
  • startDate (TEXT, Optional): Start date of the time period searched for the search query. Lower bound (exclusive) for an event’s end time to filter by. Optional. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ign…
  • endDate (TEXT, Optional): End date of the time period searched for the search query. Upper bound (exclusive) for an event’s start time to filter by. Optional. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ign…
  • maxResults (TEXT, Optional): Maximum number of results to return (optional, default: 10)
  • eventType (TEXT, Optional): The type of event to filter for. Allowed values: default, focusTime, outOfOffice, workingLocation, etc. See Google Calendar API docs for full list. Provide only one singele event type.
  • desc (BOOLEAN, Optional): Select if the results be ordered in descending order (start time).
Output: Returns the operation result

​
Delete event

google_calendar.delete_event
Deletes an event Requires Confirmation: Yes Parameters:
  • eventId (ID, Required): Id of the event that will be deleted. For event series note that if you provide an event instance id, it will delete just that instance, and if you provide a recurring event’s master id, it will delete the entire series. For an event instance id of a reoccuring event like 7hagg0gtspd2b03lm8i3g4ir…
  • calendarId (ID, Required): The id of the calendar (e.g. ‘primary’ for the main calendar)
Output: Returns the operation result

​
List calendars

google_calendar.list_calendars
Lists all calendars accessible to the authenticated user using the Google Calendar API /users/me/calendarList endpoint. Requires Confirmation: No Parameters:
  • maxResults (TEXT, Optional): Maximum number of entries to return in one result page (default: 100, max: 250).
  • minAccessRole (TEXT, Optional): Restricts results to calendars where the user has at least this access role. Allowed values: freeBusyReader, reader, writer, owner.
  • pageToken (TEXT, Optional): Token specifying which result page to return (for pagination).
  • showDeleted (BOOLEAN, Optional): Whether to include deleted calendar list entries in the result (default: false).
  • showHidden (BOOLEAN, Optional): Whether to show hidden entries (default: false).
  • syncToken (TEXT, Optional): For incremental sync, only return entries changed since the previous request with this token. Cannot be used with minAccessRole.
Output: Returns the operation result

​
Get free/busy for calendar

google_calendar.get_free_busy
Retrieves free/busy information for one or more calendars over a specified time range using the Google Calendar API /freeBusy endpoint. Requires Confirmation: No Parameters:
  • items (TEXT, Required): List of calendar IDs to check (e.g., emails, resource IDs, or ‘primary’). Enter as a comma-separated list.
  • timeMin (TEXT, Required): RFC3339 timestamp for the start of the time range to check (inclusive). Example: 2025-05-15T08:00:00Z
  • timeMax (TEXT, Required): RFC3339 timestamp for the end of the time range to check (exclusive). Example: 2025-05-15T18:00:00Z
  • timeZone (TEXT, Optional): Time zone for the response (optional, defaults to UTC). Example: Europe/Berlin
Output: Returns the operation result

​
Triggers

​
New event

google_calendar.new_event
Triggers when new calendar events are created in specified calendars Parameters:
  • calendarId (TEXT, Optional): ID of the calendar to monitor for new events. Identifies which specific calendar to check for new events
  • daysToInclude (TEXT, Optional): Number of days in the future to look for events. Default is 30 days
Output: Returns the operation result

​
Event start

google_calendar.event_start
Triggers when events are about to start within a specified time window Parameters:
  • minuteBefore (TEXT, Required): Number of minutes before an event starts to trigger the workflow. Default is 15 minutes
  • calendarId (TEXT, Optional): ID of the calendar to monitor. Defaults to your primary calendar if not specified
Output: Returns the operation result
google_calendar.new_event_matching_search
Triggers when new calendar events matching the specified search query are created Parameters:
  • searchQuery (TEXT, Required): Text to search for in event subjects. Examples: ‘Meeting’, ‘Review’, ‘Project kickoff’
  • calendarId (TEXT, Optional): ID of the calendar to monitor for new events. Identifies which specific calendar to check for new events
  • daysToInclude (NUMBER, Optional): Number of days in the future to look for events. Default is 30 days
Output: Returns the operation result