Google Calendar

Allow Suger to access and manage your Google Calendar events, enabling automated scheduling and calendar management workflows.

Overview

Google Calendar is a time management and scheduling service developed by Google. It allows users to create, edit, and manage events and calendars, with support for reminders, guest invites, and integration with other Google Workspace services.

By integrating Suger with Google Calendar, users can automate workflow tasks such as creating calendar events, managing schedules, sending invites, and synchronizing calendar data across systems for efficient appointment and meeting management.

Org-Level vs User-Level

When to use Org-Level: Use org-level integration when you want all users in your organization to have access to Google Calendar data through a shared service account. Best for company-wide calendar access and scheduling automation.

When to use User-Level: Use user-level integration when each user needs to connect their personal Google Calendar account. Each user authenticates with their own credentials to access their private calendar events and schedules.

Create Integration (Org-Level)

Prerequisites

A GCP project with the Calendar API enabled
A service account with appropriate IAM permissions

Authenticate by Service Account

Create a service account in your target GCP project for Google Calendar integration.
Info
- Grant the service account with the IAM role Service Account Token Creator under the GCP project.
Enable the Google Calendar API in the same Google project.
Create the service account key, and download the associated JSON file. It is required for the following integration.
Enable G-Suite Domain-wide Delegation for the service account.
Info
- In the “OAuth Scopes” field, select the appropriate scopes for Google Calendar access.
Specify the impersonated email address, select the appropriate scopes configured in the previous step, and store the JSON key file contents within the Suger console integration page.
Info
- Enter the Impersonation Email (a user email from your company) that Suger will impersonate to access calendar on behalf of the user. It MUST be a user email, instead of a group email, since group emails cannot be impersonated.
- Select the appropriate OAuth scopes for calendar access.

Create User Integration

Click Connect Now button in the User Integrations section
Select OAuth2.0 as the authentication method and click Create
You will be redirected to Google to authorize
Click Allow to grant Suger permission to access your Google Calendar
Return to Suger to confirm connection
Verify the integration by clicking the Verify button. If the integration is successful, you will see the Verified status.

Suger AI Tools

Suger AI uses a middleware strategy — wrapping the Google Calendar API directly.

Org-level and user-level: Both integration levels are supported. User-level takes precedence when both are connected.

Calendars

Tool	Description
`googlecalendar_list_calendars`	List calendars the user has subscribed to
`googlecalendar_get_calendar`	Get the user’s view of a calendar
`googlecalendar_describe_calendar`	Get canonical calendar metadata
`googlecalendar_create_calendar`	Create a new secondary calendar
`googlecalendar_update_calendar`	Update a calendar’s summary, description, or timezone
`googlecalendar_delete_calendar`	Permanently delete a secondary calendar
`googlecalendar_clear_primary_calendar`	Delete all events from the primary calendar
`googlecalendar_subscribe_to_calendar`	Subscribe to a shared calendar
`googlecalendar_update_subscribed_calendar`	Update user-specific view of a subscribed calendar
`googlecalendar_unsubscribe_calendar`	Unsubscribe from a calendar
`googlecalendar_get_colors`	Get the color palette for events and calendars
`googlecalendar_list_settings`	List the user’s Calendar settings
`googlecalendar_get_setting`	Get a single Calendar setting by ID

Events

Tool	Description
`googlecalendar_list_events`	List events (expands recurring series with singleEvents=true)
`googlecalendar_get_event`	Get a specific event by ID
`googlecalendar_create_event`	Create a new event (supports Google Meet, all-day, recurring)
`googlecalendar_update_event`	Partially update an event
`googlecalendar_delete_event`	Delete an event
`googlecalendar_move_event`	Move an event to a different calendar
`googlecalendar_quick_add_event`	Create an event from a natural-language string
`googlecalendar_import_event`	Import an event from an external calendar
`googlecalendar_list_event_instances`	List instances of a recurring event
`googlecalendar_get_free_busy`	Query free/busy windows for one or more calendars

Sharing (ACL)

Tool	Description
`googlecalendar_list_calendar_acl`	List ACL rules for a calendar
`googlecalendar_get_calendar_acl_rule`	Get one ACL rule by ID
`googlecalendar_share_calendar`	Share a calendar with a user, group, or domain
`googlecalendar_update_calendar_acl_rule`	Change the role of an existing ACL rule
`googlecalendar_unshare_calendar`	Revoke a calendar share

Edit Integration

Editing is not supported for security reasons. To change configuration, delete the integration and create a new one.

Delete Integration

The Google Calendar integration can be deleted like all other integrations. Once the deletion is triggered, all integration info including the service account with the key will be deleted immediately & permanently from Suger. No time window or methods to recover.