Back to Autogpt

Google Calendar

docs/integrations/block-integrations/google/calendar.md

0.6.444.1 KB
Original Source

Google Calendar

<!-- MANUAL: file_description -->

Blocks for creating and reading events from Google Calendar.

<!-- END MANUAL -->

Google Calendar Create Event

What it is

This block creates a new event in Google Calendar with customizable parameters.

How it works

<!-- MANUAL: how_it_works -->

This block creates events in Google Calendar via the Google Calendar API. It handles various event parameters including timing, location, guest invitations, Google Meet links, and recurring schedules. The block authenticates using your connected Google account credentials.

When you specify guests, they receive email invitations (if notifications are enabled). The Google Meet option adds a video conference link to the event automatically.

<!-- END MANUAL -->

Inputs

InputDescriptionTypeRequired
event_titleTitle of the eventstrYes
locationLocation of the eventstrNo
descriptionDescription of the eventstrNo
timingSpecify when the event starts and endsTimingNo
calendar_idCalendar ID (use 'primary' for your main calendar)strNo
guest_emailsEmail addresses of guests to inviteList[str]No
send_notificationsSend email notifications to guestsboolNo
add_google_meetInclude a Google Meet video conference linkboolNo
recurrenceWhether the event repeatsRecurrenceNo
reminder_minutesWhen to send reminders before the eventList[int]No

Outputs

OutputDescriptionType
errorError message if the operation failedstr
event_idID of the created eventstr
event_linkLink to view the event in Google Calendarstr

Possible use case

<!-- MANUAL: use_case -->

Automated Meeting Scheduling: Create calendar events when appointments are booked through a form or scheduling system.

Event Reminders: Schedule events with custom reminder notifications for team deadlines or milestones.

Team Coordination: Create recurring meetings with Google Meet links when onboarding new team members.

<!-- END MANUAL -->

Google Calendar Read Events

What it is

Retrieves upcoming events from a Google Calendar with filtering options

How it works

<!-- MANUAL: how_it_works -->

This block fetches upcoming events from Google Calendar using the Calendar API. It retrieves events within a specified time range, with options to filter by search term or exclude declined events. Pagination support allows handling large numbers of events.

Events are returned with details like title, time, location, and attendees. Use 'primary' as the calendar_id to access your main calendar.

<!-- END MANUAL -->

Inputs

InputDescriptionTypeRequired
calendar_idCalendar ID (use 'primary' for your main calendar)strNo
max_eventsMaximum number of events to retrieveintNo
start_timeRetrieve events starting from this timestr (date-time)No
time_range_daysNumber of days to look ahead for eventsintNo
search_termOptional search term to filter events bystrNo
page_tokenPage token from previous request to get the next batch of events. You can use this if you have lots of events you want to process in a loopstrNo
include_declined_eventsInclude events you've declinedboolNo

Outputs

OutputDescriptionType
errorError message if the request failedstr
eventsList of calendar events in the requested time rangeList[CalendarEvent]
eventOne of the calendar events in the requested time rangeCalendarEvent
next_page_tokenToken for retrieving the next page of events if more existstr

Possible use case

<!-- MANUAL: use_case -->

Daily Briefings: Fetch today's events to generate a morning summary or prepare for upcoming meetings.

Schedule Conflicts: Check for overlapping events before scheduling new appointments.

Meeting Preparation: Retrieve upcoming meetings to pre-load relevant documents or send reminders.

<!-- END MANUAL -->