[Google Calendar] Search Events
The [Google Calendar] Search Events block queries a Google Calendar and returns a list of matching events based on a keyword, a date range, or a combination of both.
Search Google Calendar events by keyword or date range
The [Google Calendar] Search Events block queries a Google Calendar and returns a list of matching events based on a keyword, a date range, or a combination of both. It connects to a Google Calendar account via OAuth and targets a specific calendar by ID, defaulting to the primary calendar if none is specified. You can control how many results come back using the limit parameter, which defaults to 10, and choose whether the output is formatted as JSON or plain text.
The block accepts an optional text query to match against event content, along with optional timeMin and timeMax values in ISO 8601 format to filter events within a specific window. Unlike a simple list operation, this block can surface past events as well as upcoming ones, making it useful for historical lookups. Results are stored in a destination variable you define.
Each event in the output includes fields like summary, start and end times with time zone, status, a direct HTML link, description, location, and a list of attendees with their display names, email addresses, and response statuses. This block fits naturally into workflows that need to check scheduling conflicts, summarize past meetings, look up event details before sending a follow-up, or build calendar-aware assistants.
What you can build
Real-world workflows powered by the [Google Calendar] Search Events block.
Meeting Conflict Detection
Before scheduling a new event, query the calendar within a specific time window to check whether any existing events overlap with the proposed time slot.
Past Meeting Summarization
Retrieve completed meetings by date range and pass their descriptions and attendee lists to an AI block to generate a summary or action item report.
Event-Triggered Follow-Ups
Search for events matching a specific keyword or project name, then automatically draft follow-up emails to attendees based on the event details.
Calendar-Aware Scheduling Assistant
Power a conversational AI assistant that looks up a user's calendar in real time to answer questions like 'What do I have on Friday?' or 'When is my next team sync?'
Weekly Agenda Digest
At the start of each week, retrieve all events within the next seven days and format them into a structured digest delivered via email or messaging platform.
Project Timeline Auditing
Search past calendar events by project keyword to compile a timeline of meetings and milestones, useful for retrospectives or billing documentation.
Ready to add [Google Calendar] Search Events to your workflow?
Get Started FreeCommon questions about [Google Calendar] Search Events
What parameters are required to use this block?
The block requires a Google OAuth connection ID with Calendar events scope. All search parameters — query, timeMin, timeMax, calendarId, and limit — are optional. If no calendarId is provided, the block defaults to the primary calendar. If no limit is set, it returns up to 10 events.
What does the block return for each event?
Each event in the output array includes an id, summary, start and end date-times with time zones, status, an htmlLink, description, location, and an attendees array. Each attendee entry contains a displayName, email, and responseStatus.
Can this block retrieve past events, not just future ones?
Yes. By specifying a timeMin and timeMax range that falls in the past, the block can return historical events. This distinguishes it from a basic list operation that only surfaces upcoming events.
What format options are available for the output?
The exportType field accepts either 'json' or 'text', which controls how the result is formatted when stored in the destination variable. JSON is suitable for downstream blocks that process structured data, while text may be more convenient for passing directly into an AI prompt.
What kinds of workflows is this block commonly used in?
This block is commonly used in scheduling assistants, meeting follow-up automations, weekly agenda generators, conflict detection flows, and any workflow that needs to retrieve or reason about calendar event data based on time or topic.
Related capabilities
[Google] Create Google Doc
Create a new Google Document and optionally populate it with content.
[Google] Update Google Doc
Update the contents of an existing Google Document.
[Google] Fetch Google Doc
Fetch the contents of an existing Google Document.
[Google] Create Google Sheet
Create a new Google Spreadsheet and populate it with CSV data.
[Google] Update Google Sheet
Update a Google Spreadsheet with new data.
[Google] Fetch Google Sheet
Fetch contents of a Google Spreadsheet range.
Add [Google Calendar] Search Events to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.