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.
- Go to Organization > Connectors and find Google Calendar. Click Enable, and choose which tools to allow.
- Create a Google Cloud project.
- Turn on the Google Calendar API.
- Configure the OAuth consent screen.
- Create credentials, choose OAuth client ID, and set the type to Web application.
- Add the exact Redirect URI shown in the connector settings.
- Copy the client ID and client secret into the connector, then save it.
- 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/calendarhttps://www.googleapis.com/auth/calendar.aclshttps://www.googleapis.com/auth/calendar.acls.readonlyhttps://www.googleapis.com/auth/calendar.calendarlisthttps://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.calendarshttps://www.googleapis.com/auth/calendar.calendars.readonlyhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.freebusyhttps://www.googleapis.com/auth/calendar.readonlyhttps://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.
| Tool | What it does |
|---|---|
get_acl_rule | Get one calendar-sharing rule: who it grants access to and at what level. |
get_calendar | Get a calendar's shared properties: title, description, timezone and location. |
get_calendar_from_list | Get YOUR view of a calendar: custom colour, display-name override, notification preferences, whether it is hidden or selected. |
get_colors | List the colour IDs valid for color_id on events and calendars, with their hex values. |
get_event | Get one event in full: times, attendees and their RSVPs, recurrence, reminders and conferencing. |
get_event_instances | Retrieve all instances of a recurring event within a time range. |
get_user_setting | Read one of the signed-in user's Calendar preferences by ID, such as 'timezone', 'weekStart', 'format24HourTime' or 'locale'. |
list_acl_rules | Show who a calendar is shared with and at what access level. |
list_calendar_list | Lists your calendars - primary, ones you own, and ones you subscribe to - with your access role for each. |
list_events | List events. |
list_user_settings | List every Calendar preference for the signed-in user with its current value, including timezone, locale, weekStart and format24HourTime. |
query_freebusy | Get raw busy periods for up to 50 calendars in a time range. |
search_events | Find events matching search text on one calendar. |
suggest_time | Find meeting slots when everyone is free, by reading each attendee's busy times and returning bookable openings. |
validate_credential | Validate Google Calendar credentials. |
Write (9)
Create or send data.
| Tool | What it does |
|---|---|
add_calendar_to_list | Subscribe to an existing calendar so it appears in your list, optionally setting your own colour, display name and notifications. |
create_acl_rule | Share 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_calendar | Create a new secondary calendar you own. |
create_event | Create an event. |
quick_add_event | Create an event from natural language, e.g. 'Lunch with John tomorrow at 12pm'; Google parses date, time and title. |
watch_acl_rules | Send a POST to your HTTPS endpoint whenever this calendar's sharing changes. |
watch_calendar_list | Send a POST to your HTTPS endpoint whenever your calendar list changes. |
watch_events | Send a POST to your HTTPS endpoint whenever events on this calendar change. |
watch_user_settings | Send a POST to your HTTPS endpoint whenever the user's Calendar preferences change. |
Delete or overwrite (18)
Remove or replace existing data.
| Tool | What it does |
|---|---|
clear_calendar | Permanently delete ALL events from the account's PRIMARY calendar. |
delete_acl_rule | Stop sharing a calendar with someone by deleting their access rule. |
delete_calendar | Permanently delete a secondary calendar and all its events. |
delete_event | Cancel and permanently delete an event. |
import_event | Import an event that already exists elsewhere, keeping its original iCalUID so it is not duplicated. |
move_event | Move an event to a different calendar, changing its organizer. |
patch_acl_rule | Partially update an ACL rule. |
patch_calendar | Update some of a calendar's metadata (title, description, location, timezone), leaving fields you omit unchanged. |
patch_calendar_in_list | Change individual settings of YOUR view of a subscribed calendar - colour, display name, hidden, selected, notifications - leaving anything you omit untouched. |
patch_event | Update specific fields of an event; fields you omit are left alone. |
remove_calendar_from_list | Unsubscribe yourself from a calendar. |
respond_to_event | RSVP to an event you have been invited to: accept, decline, or mark tentative, optionally with a note to the organiser. |
stop_watch_channel | Stop a push notification channel. |
transfer_calendar_ownership | Transfer a secondary calendar to another user in the same Google Workspace organisation. |
update_acl_rule | Completely replace an ACL rule. |
update_calendar | Replace a calendar's shared metadata. |
update_calendar_in_list | Replace YOUR settings for a subscribed calendar - colour, display name, visibility, notifications. |
update_event | Replace an event in full. |