Skip to main content

Google Calendar

Comprehensive Google Calendar connector for managing calendars, events, access control, and scheduling operations through the Google Calendar API v3.

What you can ask​

  • Find a 30-minute slot tomorrow when I, Anna, and Devon are all free.
  • Cancel my 2pm and notify the attendees with a rescheduling link.
  • List my meetings this week and flag any without an agenda in the description.

Set up​

Google Calendar needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Google Calendar. Click Enable, and choose which tools to allow.
  2. Create a Google Cloud project.
  3. Turn on the Google Calendar API.
  4. Configure the OAuth consent screen.
  5. Create credentials, choose OAuth client ID, and set the type to Web application.
  6. Add the exact Redirect URI shown in the connector settings.
  7. Copy the client ID and client secret into the connector, then save it.
  8. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Google Calendar login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (12)

Grant the scopes for the tools you plan to allow.

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.acls
  • https://www.googleapis.com/auth/calendar.acls.readonly
  • https://www.googleapis.com/auth/calendar.calendarlist
  • https://www.googleapis.com/auth/calendar.calendarlist.readonly
  • https://www.googleapis.com/auth/calendar.calendars
  • https://www.googleapis.com/auth/calendar.calendars.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.readonly
  • https://www.googleapis.com/auth/calendar.freebusy
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.settings.readonly

Tools​

Google Calendar offers 42 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (15)​

View and search information without changing it.

ToolWhat it does
get_acl_ruleGet one calendar-sharing rule: who it grants access to and at what level.
get_calendarGet a calendar's shared properties: title, description, timezone and location.
get_calendar_from_listGet YOUR view of a calendar: custom colour, display-name override, notification preferences, whether it is hidden or selected.
get_colorsList the colour IDs valid for color_id on events and calendars, with their hex values.
get_eventGet one event in full: times, attendees and their RSVPs, recurrence, reminders and conferencing.
get_event_instancesRetrieve all instances of a recurring event within a time range.
get_user_settingRead one of the signed-in user's Calendar preferences by ID, such as 'timezone', 'weekStart', 'format24HourTime' or 'locale'.
list_acl_rulesShow who a calendar is shared with and at what access level.
list_calendar_listLists your calendars - primary, ones you own, and ones you subscribe to - with your access role for each.
list_eventsList events.
list_user_settingsList every Calendar preference for the signed-in user with its current value, including timezone, locale, weekStart and format24HourTime.
query_freebusyGet raw busy periods for up to 50 calendars in a time range.
search_eventsFind events matching search text on one calendar.
suggest_timeFind meeting slots when everyone is free, by reading each attendee's busy times and returning bookable openings.
validate_credentialValidate Google Calendar credentials.

Write (9)​

Create or send data.

ToolWhat it does
add_calendar_to_listSubscribe to an existing calendar so it appears in your list, optionally setting your own colour, display name and notifications.
create_acl_ruleShare a calendar by granting access to a user, group, or Workspace domain. scope_type='default' publishes it to ANYONE on the internet, including people not signed in, and requires confirm_public=true.
create_calendarCreate a new secondary calendar you own.
create_eventCreate an event.
quick_add_eventCreate an event from natural language, e.g. 'Lunch with John tomorrow at 12pm'; Google parses date, time and title.
watch_acl_rulesSend a POST to your HTTPS endpoint whenever this calendar's sharing changes.
watch_calendar_listSend a POST to your HTTPS endpoint whenever your calendar list changes.
watch_eventsSend a POST to your HTTPS endpoint whenever events on this calendar change.
watch_user_settingsSend a POST to your HTTPS endpoint whenever the user's Calendar preferences change.

Delete or overwrite (18)​

Remove or replace existing data.

ToolWhat it does
clear_calendarPermanently delete ALL events from the account's PRIMARY calendar.
delete_acl_ruleStop sharing a calendar with someone by deleting their access rule.
delete_calendarPermanently delete a secondary calendar and all its events.
delete_eventCancel and permanently delete an event.
import_eventImport an event that already exists elsewhere, keeping its original iCalUID so it is not duplicated.
move_eventMove an event to a different calendar, changing its organizer.
patch_acl_rulePartially update an ACL rule.
patch_calendarUpdate some of a calendar's metadata (title, description, location, timezone), leaving fields you omit unchanged.
patch_calendar_in_listChange individual settings of YOUR view of a subscribed calendar - colour, display name, hidden, selected, notifications - leaving anything you omit untouched.
patch_eventUpdate specific fields of an event; fields you omit are left alone.
remove_calendar_from_listUnsubscribe yourself from a calendar.
respond_to_eventRSVP to an event you have been invited to: accept, decline, or mark tentative, optionally with a note to the organiser.
stop_watch_channelStop a push notification channel.
transfer_calendar_ownershipTransfer a secondary calendar to another user in the same Google Workspace organisation.
update_acl_ruleCompletely replace an ACL rule.
update_calendarReplace a calendar's shared metadata.
update_calendar_in_listReplace YOUR settings for a subscribed calendar - colour, display name, visibility, notifications.
update_eventReplace an event in full.
⌘J