Google Calendar

GOOGLECALENDAR_EVENTS_LIST

Returns events on the specified calendar.

Remote googlecalendar

Other tools also called GOOGLECALENDAR_EVENTS_LIST? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "q": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Free text search terms to find events that match these terms in various fields. Optional."
    },
    "iCalUID": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID."
    },
    "orderBy": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: \"startTime\", \"updated\". When set to \"startTime\", singleEvents must be true. The action automatically sets singleEvents=true when orderBy='startTime'."
    },
    "timeMax": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Upper bound (exclusive) for an event's start time to filter by. Optional. If unset, no start-time upper bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin."
    },
    "timeMin": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Lower bound (exclusive) for an event's end time to filter by. Optional. If unset, no end-time lower bound is applied. Must be an RFC3339 timestamp with mandatory time zone offset (e.g., 2011-06-03T10:00:00-07:00 or 2011-06-03T10:00:00Z). Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax."
    },
    "timeZone": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Time zone used in the response. Optional. Use an IANA time zone identifier (e.g., America/Los_Angeles). Defaults to the user's primary time zone. Offsets (e.g., '-03:00', 'UTC+0') and abbreviations (e.g., 'IST', 'PST') are invalid."
    },
    "pageToken": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Token specifying which result page to return. Optional."
    },
    "syncToken": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Token from nextSyncToken to return only entries changed since the last list. Cannot be combined with iCalUID, orderBy, privateExtendedProperty, q, sharedExtendedProperty, timeMin, timeMax, or updatedMin. Deletions since the previous list are always included; showDeleted cannot be false in this mode. The action automatically removes conflicting parameters when syncToken is provided."
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the \"primary\" keyword.\nExample: \"primary\""
    },
    "eventTypes": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types. Acceptable values are: \"birthday\", \"default\", \"focusTime\", \"fromGmail\", \"outOfOffice\", \"workingLocation\"."
    },
    "maxResults": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are more events matching the query. Incomplete pages can be detected by a non-empty nextPageToken field in the response. By default the value is 250 events. The page size can never be larger than 2500 events. Optional."
    },
    "updatedMin": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Lower bound for an event's last modification time (RFC3339). When specified, entries deleted since this time are always included regardless of showDeleted. Optional."
    },
    "showDeleted": {
      "type": [
        "boolean",
        "null"
      ],
      "default": null,
      "description": "Include cancelled events (status=\"cancelled\"). Optional; default is false. This surfaces cancelled (soft-deleted) events, not items in the Trash. When syncToken or updatedMin is used, deletions since those markers are included regardless of showDeleted. Recurring interaction: if singleEvents=false and showDeleted=false, cancelled instances of a recurring series may still be included; if showDeleted=true and singleEvents=true, only single deleted instances (not parent series) are returned."
    },
    "maxAttendees": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional. Must be >= 1 if provided."
    },
    "singleEvents": {
      "type": [
        "boolean",
        "null"
      ],
      "default": null,
      "description": "Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is False."
    },
    "alwaysIncludeEmail": {
      "type": [
        "boolean",
        "null"
      ],
      "default": null,
      "description": "Deprecated and ignored."
    },
    "showHiddenInvitations": {
      "type": [
        "boolean",
        "null"
      ],
      "default": null,
      "description": "Whether to include hidden invitations in the result. Optional. The default is False. Hidden invitations are events where your attendee entry has responseStatus='needsAction' and attendees[].self==true. When true, such invitations are included."
    },
    "sharedExtendedProperty": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple times to return events that match all given constraints."
    },
    "privateExtendedProperty": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple times to return events that match all given constraints."
    }
  }
}