> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clarion.cantina.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Calendar

> Sync the on-call rotation to a Google Calendar so anyone on the team can see who is on call at a glance.

This guide shows how to connect Google Calendar to Clarion. Once connected, Clarion automatically writes on-call shifts to a calendar you choose and keeps them updated as the rotation changes.

<Note>
  **Estimated time:** 2 minutes. You need access to:

  * A **Clarion workspace** with permission to manage integrations
  * A **Google account** with permission to authorize third-party apps for the calendar you want to use
</Note>

## Prerequisites

* A Google account with access to the calendar you want Clarion to write to. Any Google account works — personal Gmail, Google Workspace, or a shared account.
* An on-call rotation defined in Clarion under **Settings → Notifications**. If the rotation is empty, the connection is still allowed but no events appear until you add slots.

***

## Step 1 - Connect Google Calendar

1. In Clarion, open **Integrations** and find **Google Calendar**.
2. Click **Connect Google Calendar**. You'll be redirected to Google to authorize Clarion.
3. Review the requested permissions in Google, then click **Continue**.

Google redirects you back to Clarion with the connection established. Clarion now needs one more choice: which calendar to write to.

***

## Step 2 - Choose a target calendar

On the Google Calendar integration page, pick where Clarion should write the on-call shifts:

* **Create a new Clarion On-Call calendar** *(recommended)*: Clarion creates a dedicated calendar in the connected Google account named **Clarion On-Call**. Best for teams who want a clean, isolated view of the rotation.
* **Use an existing calendar**: Pick any calendar you have write access to. Best when you already have a shared team calendar.

Click **Save target calendar**. Clarion runs an initial sync and writes the next 12 weeks of on-call shifts. Each shift is an all-day event titled with the on-call member's name.

<Info>
  The on-call member is added as an **attendee** on their shift, so the event also appears on their personal calendar automatically. Google emails each new attendee once when Clarion first schedules them — subsequent edits (rotation reorders, description tweaks) stay quiet.
</Info>

***

## What Clarion syncs

Every event Clarion writes:

* Is an **all-day** event covering the full length of the shift (7 days for weekly rotations, 14 days for biweekly).
* Has the on-call member(s) as attendees, so shifts also appear on their personal calendars.
* Sets a **24-hour popup reminder** on the shared Clarion calendar. Each attendee's personal copy uses their own Google Calendar default reminders — you can override per-event or globally in Google Calendar settings.
* Includes a link back to the Clarion **Settings → Notifications** page for context.

When the rotation changes — new member added, slots reordered, cadence changed — Clarion patches the affected events on the next sync (immediately after you save the rotation, plus a daily background pass).

***

## Manually resync

On the Google Calendar integration page, click **Sync now** to reconcile the calendar immediately. Useful when:

* You just updated the rotation and don't want to wait for the automatic sync.
* Someone deleted a Clarion event manually — resync restores it.
* The last-sync line shows an error.

***

## Reconnecting after Google revokes access

If Google revokes Clarion's access (for example, when the person who connected removes Clarion from their Google account), the integration surfaces a **Reconnect Google Calendar** button on the settings page. Clicking through the OAuth flow again restores the sync — the target calendar setting is remembered, so no manual re-picking is needed.

***

## Disconnect

To stop syncing:

1. Open the **Google Calendar** integration in Clarion.
2. Click **Disconnect**.
3. Confirm the dialog.

Behavior depends on the target calendar:

* If Clarion **created** the calendar for you, that calendar is deleted from Google along with its events.
* If you pointed Clarion at an **existing** calendar, only the events Clarion added are removed. Everything else on the calendar is left untouched.