Manage events and schedules in Google Calendar with timezone-aware event handling
Google Calendar allows you to manage calendar events programmatically. You can list events, create new appointments, update existing events, check availability with free/busy information, manage attendees, set reminders, and handle recurring events. This integration supports timezone-aware scheduling, making it perfect for meeting coordination, event planning, and calendar automation.
Required:
action
- The operation to perform on calendar eventsGet all calendars accessible to the user
Parameters:
Example:
Response:
Get events from a calendar within a date range
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)time-min
(optional) - Start date/time in ISO formattime-max
(optional) - End date/time in ISO formattimezone
(optional) - Timezone for the queryExample:
Response:
Create a new calendar event
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)summary
(required) - Event titlestart-datetime
(required) - Start date/time with timezone offsetend-datetime
(required) - End date/time with timezone offsettimezone
(required) - Event timezonelocation
(optional) - Event locationdescription
(optional) - Event descriptionattendees
(optional) - Comma-separated email addressesExample:
Response:
Update an existing calendar event
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)event-id
(required) - Event ID to updatesummary
(optional) - New event titlestart-datetime
(optional) - New start timeend-datetime
(optional) - New end timelocation
(optional) - New locationattendees
(optional) - Updated attendee listExample:
Response:
Delete a calendar event
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)event-id
(required) - Event ID to deleteExample:
Response:
Check availability for one or more calendars
Parameters:
time-min
(required) - Start of time rangetime-max
(required) - End of time rangetimezone
(required) - Timezone for the querycalendars
(optional) - Comma-separated calendar IDs (default: “primary”)Example:
Response:
Create an event that repeats on a schedule
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)summary
(required) - Event titlestart-datetime
(required) - First occurrence start timeend-datetime
(required) - First occurrence end timetimezone
(required) - Event timezonerecurrence
(required) - Recurrence rule (e.g., “WEEKLY”, “DAILY”)frequency-details
(optional) - Additional recurrence detailsExample:
Response:
Add or update reminders for an event
Parameters:
calendar-id
(optional) - Calendar ID (default: “primary”)event-id
(required) - Event IDpopup-minutes
(optional) - Minutes before event for popup reminderemail-minutes
(optional) - Minutes before event for email reminderExample:
Response:
All date/time values must include timezone offsets (e.g., -08:00 for PST). The system automatically retrieves the user’s timezone from Google Calendar settings. When listing events without specifying a date range, it defaults to the current day in the user’s timezone. Recurring events use RRULE format for recurrence patterns. Maximum 2500 events can be retrieved per request.