📖 Definition

The Find Calendar Events action 🔎 allows you to search for and retrieve Google Calendar events based on specific search criteria, such as keywords, time range, or calendar selection. It enables you to filter results, handle recurring events, include deleted events if needed, and control the number of events returned. This action is powerful for automating calendar management, reporting, auditing, or triggering workflows based on calendar events.

Example Use cases

🗓️ Automated Meeting Summaries
Search for meetings based on keywords like "Weekly Sync" and automatically generate summaries or follow-up tasks.

🔍 Audit Calendar Events
Retrieve all events created within a specific timeframe to audit user activity or meeting patterns across teams.

✈️ Track Business Travel Events
Find calendar events containing travel-related keywords (e.g., "flight," "hotel") to manage itineraries and expenses.

📈 Event-Based Reporting
Generate reports on the number of client meetings, training sessions, or project milestones scheduled over a period.

🔔 Trigger Notifications
Search for high-priority events and send reminders or custom notifications to relevant stakeholders automatically.

Inputs

🔌 Connection
Provide your Google Workspace Administration connection. You must upload a credential JSON file for a service account with domain-wide delegation. Guide to create one.

📧 User Email
Enter the primary email address of the user whose calendar events you want to search.

📅 Calendar
Input either the user's primary email address or the ID of a secondary calendar to specify where to search for events.

🔎 Search Text
Enter the text or keyword to search for within the event titles, descriptions, or other fields. Useful for finding specific meetings or topics.

🗑️ Include Deleted Events
Check this box if you want to include events that have been deleted but are still recoverable from the trash.

♻️ Expand Recurring Events
Enable this option if you want to retrieve each occurrence of a recurring event separately rather than grouped.

Number of Events to Return

Set the number of events you wish to retrieve. Minimum is 1 and maximum is 2500.

🌎 Search Events After — Timezone
Specify the time zone context for setting the event's start time filter. You can set to "auto" or manually select a time zone.

🕐 Search Events After — Start Date Time
Select a specific date and time (via date picker or token picker) after which events will be searched. This helps narrow down the results to more recent or future events.

Example

A company HR manager needs to find all upcoming interviews scheduled within the next month across different team calendars.
Using the Find Calendar Events action, they set the User Email to the calendar owner’s address, specify a Search Text like "Interview", set the Start Date Time to today’s date, and retrieve up to 100 matching events. This allows the HR team to quickly gather all interview details without manually checking each calendar.