Google Calendar
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.
Remote googlecalendar
Other tools also called GOOGLECALENDAR_FIND_EVENT?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": [
"string",
"null"
],
"default": null,
"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.\nExamples:\n \"Project Alpha Review\"\n \"Birthday Party\"\n \"Q3 Planning session\""
},
"timeMax": {
"type": [
"string",
"null"
],
"default": null,
"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')\nExamples:\n \"2024-12-31T23:59:59Z\"\n \"2025-01-01 10:00:00\""
},
"timeMin": {
"type": [
"string",
"null"
],
"default": null,
"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')\nExamples:\n \"2024-01-01T00:00:00Z\"\n \"2024-06-15 09:00:00\""
},
"order_by": {
"type": [
"string",
"null"
],
"default": null,
"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).\nExamples:\n \"startTime\"\n \"updated\""
},
"page_token": {
"type": [
"string",
"null"
],
"default": null,
"description": "Token from a previous response's `nextPageToken` to fetch the subsequent page of results."
},
"calendar_id": {
"type": "string",
"default": "primary",
"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.\nExamples:\n \"primary\"\n \"[email protected]\"\n \"[email protected]\""
},
"event_types": {
"type": "array",
"items": {
"enum": [
"birthday",
"default",
"focusTime",
"outOfOffice",
"workingLocation"
],
"type": "string",
"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"
},
"default": [
"birthday",
"default",
"focusTime",
"outOfOffice",
"workingLocation"
],
"description": "Event types to include. Supported values: 'birthday', 'default', 'focusTime', 'outOfOffice', 'workingLocation'.\nExamples:\n \"default\"\n \"focusTime\"\n \"outOfOffice\"\n \"birthday\"\n \"workingLocation\""
},
"max_results": {
"type": "integer",
"default": 10,
"description": "Maximum number of events per page (1-2500)."
},
"updated_min": {
"type": [
"string",
"null"
],
"default": null,
"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')\nExample: \"2024-07-01T00:00:00Z\""
},
"show_deleted": {
"type": [
"boolean",
"null"
],
"default": null,
"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",
"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."
}
}
}