Google Super
GOOGLESUPER_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.
Remote googlesuper
Other tools also called GOOGLESUPER_FIND_EVENT?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"title": "Query",
"default": null,
"examples": [
"Project Alpha Review",
"Birthday Party",
"Q3 Planning session"
],
"nullable": true,
"description": "Free-text search terms to find events. This query is matched against various event fields including summary, description, location, attendees' details (displayName, email), and organizer's details."
},
"timeMax": {
"type": "string",
"title": "Time Max",
"default": null,
"examples": [
"2024-12-31T23:59:59Z",
"2025-01-01 10:00:00"
],
"nullable": true,
"description": "Upper bound (exclusive) for an event's start time to filter by. Only events starting before this time are included. Accepts multiple formats:\n1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z')\n2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00')\n3. Simple datetime string (e.g., '2024-12-06 13:00:00')"
},
"timeMin": {
"type": "string",
"title": "Time Min",
"default": null,
"examples": [
"2024-01-01T00:00:00Z",
"2024-06-15 09:00:00"
],
"nullable": true,
"description": "Lower bound (exclusive) for an event's end time to filter by. Only events ending after this time are included. Accepts multiple formats:\n1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z')\n2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00')\n3. Simple datetime string (e.g., '2024-12-06 13:00:00')"
},
"order_by": {
"type": "string",
"title": "Order By",
"default": null,
"examples": [
"startTime",
"updated"
],
"nullable": true,
"description": "Order of events: 'startTime' (ascending by start time) or 'updated' (ascending by last modification time). Note: 'startTime' requires single_events=true. Use 'updated' if you need to include recurring masters (e.g., cancelled series)."
},
"page_token": {
"type": "string",
"title": "Page Token",
"default": null,
"nullable": true,
"description": "Token from a previous response's `nextPageToken` to fetch the subsequent page of results."
},
"calendar_id": {
"type": "string",
"title": "Calendar Id",
"default": "primary",
"examples": [
"primary",
"[email protected]",
"[email protected]"
],
"description": "Identifier of the Google Calendar to query. Use 'primary' for the primary calendar of the authenticated user, an email address for a specific user's calendar, or a calendar ID for other calendars."
},
"event_types": {
"type": "array",
"items": {
"enum": [
"birthday",
"default",
"focusTime",
"outOfOffice",
"workingLocation"
],
"type": "string",
"title": "EventType",
"properties": {},
"description": "Event type constraints:\n- 'birthday': Requires transparency='transparent', description must be omitted\n- 'outOfOffice': Requires calendar_id='primary', Workspace/enterprise calendar,\n transparency='opaque', location and attendees must be omitted,\n create_meeting_room must be false\n- 'focusTime': Requires Google Workspace Enterprise account with Focus Time feature enabled\n- 'workingLocation': Requires Google Workspace Enterprise account"
},
"title": "Event Types",
"default": [
"birthday",
"default",
"focusTime",
"outOfOffice",
"workingLocation"
],
"examples": [
"default",
"focusTime",
"outOfOffice",
"birthday",
"workingLocation"
],
"description": "Event types to include. Supported values: 'birthday', 'default', 'focusTime', 'outOfOffice', 'workingLocation'."
},
"max_results": {
"type": "integer",
"title": "Max Results",
"default": 10,
"description": "Maximum number of events per page (1-2500)."
},
"updated_min": {
"type": "string",
"title": "Updated Min",
"default": null,
"examples": [
"2024-07-01T00:00:00Z"
],
"nullable": true,
"description": "Lower bound (exclusive) for an event's last modification time to filter by. Only events updated after this time are included. When specified, events deleted since this time are also included, regardless of the `show_deleted` parameter. Accepts multiple formats:\n1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z')\n2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00')\n3. Simple datetime string (e.g., '2024-12-06 13:00:00')"
},
"show_deleted": {
"type": "boolean",
"title": "Show Deleted",
"default": null,
"nullable": true,
"description": "Include events whose status is 'cancelled'. This surfaces cancelled/deleted events, not a separate 'trash' view. Behavior with recurring events: when single_events=true, only individual cancelled instances are returned (the recurring master is omitted); to include cancelled recurring masters, set single_events=false. If updated_min is provided, events deleted since that time are included regardless of this flag."
},
"single_events": {
"type": "boolean",
"title": "Single Events",
"default": true,
"description": "When true, recurring event series are expanded into their individual instances. When false, only the recurring master events are returned. Note: Ordering by 'startTime' requires singleEvents=true. For large calendars, it is strongly recommended to specify both timeMin and timeMax to limit the expansion window and improve performance."
}
}
}