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.

Create Integration

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.

Connect Your Personal Google Calendar (User Integration)

In addition to the org-level service account integration above, you can connect your own Google Calendar as a User Integration. This uses a secure OAuth 2.0 connection, so your Google password is never shared or stored.

Step 1: Configure the User Integration

In the Suger Console, go to Settings > User Integrations.
Find the Google Calendar card and click Connect.
You will be redirected to the Google sign-in page. Select the account you want to sync.
Review the requested access and click Allow. This enables Suger to view and manage your calendar events.
Once redirected back to Suger, click Verify. A Verified status confirms your calendar is successfully linked.

Step 2: Manage Sync Preferences

After the initial connection, you can tailor how Suger interacts with your schedule.

Select Calendars: If you have multiple calendars (for example, Personal, Team, or Holiday), specify which one Suger should use to create marketplace events.
Update Connection: To switch accounts or refresh an expired token, delete the current integration and repeat the setup process.
Notification Alerts: Ensure your Google Calendar mobile or desktop notifications are active to receive real-time alerts for synced marketplace milestones.

Step 3: Revoke Access

If you decide to stop using the integration, deleting it in Suger removes Suger’s access. To fully clear the connection from Google’s side:

Visit your Google Account Security Settings.
Go to Your connections to third-party apps & services.
Locate Suger and click Remove Access.

Suger AI Tools

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

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.