[Google Calendar] List Events
The [Google Calendar] List Events block retrieves upcoming events from a specified Google Calendar, returning them in chronological order by start time.
List upcoming Google Calendar events by start time
The [Google Calendar] List Events block retrieves upcoming events from a specified Google Calendar, returning them in chronological order by start time. It connects to Google Calendar via an OAuth connection and fetches only future events, up to a configurable limit that defaults to 10. You can target any calendar by providing its calendar ID, or leave it blank to default to the primary calendar associated with the connected account.
The block accepts a few key configuration inputs: the OAuth connection ID for authentication, the maximum number of events to return, the calendar ID to query, and a destination variable name where the results will be stored. You can also choose whether the output variable is formatted as JSON or as text, depending on how downstream blocks in your workflow will consume it.
The block returns an array of event objects, each containing fields such as the event ID, summary, start and end times with time zones, status, a direct HTML link, description, location, and a list of attendees with their display names, email addresses, and response statuses. This makes it well-suited for workflows that need to display schedules, check availability, send reminders, or feed calendar data into AI processing steps.
What you can build
Real-world workflows powered by the [Google Calendar] List Events block.
Daily Schedule Briefing
Retrieve the day's upcoming events and pass them to an AI block to generate a natural-language summary of the user's schedule.
Meeting Reminder Notifications
Fetch upcoming events and trigger notification messages to attendees before each meeting starts.
Availability Checker
Pull a list of scheduled events to determine open time slots before booking a new appointment or meeting.
Attendee Follow-Up Automation
List events with attendee response statuses and automatically follow up with invitees who have not yet accepted.
Event Data Reporting
Aggregate calendar events across a team and feed the structured output into a reporting workflow to track meeting frequency and duration.
Location-Based Preparation
Read the location field from upcoming events and trigger workflows that provide directions, weather, or travel time estimates.
Ready to add [Google Calendar] List Events to your workflow?
Get Started FreeCommon questions about [Google Calendar] List Events
What are the required parameters for this block?
The block requires a Google OAuth connection ID with Calendar events scope. The limit field defaults to 10 if not specified, and the calendar ID defaults to "primary" if left blank. You can optionally specify a destination variable name and choose between JSON or text export format.
What does the block return?
The block returns an array of event objects. Each event includes fields for id, summary, start and end times with time zones, status, htmlLink, description, location, and an attendees array containing each attendee's display name, email address, and response status.
Does the block return past events?
No. The block only returns future events, using the current time as the minimum start boundary. Past events are excluded from the results.
What is the exportType parameter used for?
The exportType parameter controls the format of the value stored in the destination variable. Setting it to "json" stores the result as a JSON-formatted string, while "text" stores it in a text representation. The structured event array is always available from the block's direct execution output regardless of this setting.
What kinds of workflows commonly use this block?
This block is commonly used in scheduling assistants, daily briefing generators, meeting reminder systems, availability checkers, and any workflow that needs to read and act on calendar data before passing it to AI processing or notification steps.
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] List Events to your workflow
Build powerful AI workflows with drag-and-drop blocks. No coding required.