> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Google Calendar

Read calendars and events, add and change events, see when someone is busy, and start a workflow when a calendar changes.

An older Calendar entry in the app list is a different connection. This page is the direct Google Calendar connection. Signing in here does not replace that entry.

## What it can do

- Read: **List calendars**, **Get calendar list entry**, **Get calendar details**, **List events**, **Search events**, **Get event**, **List event instances**, **Query free and busy** and **Get setting**.
- Change events: **Create event**, **Quick add event**, **Update event**, **Respond to event**, **Move event**, **Delete event**, **Watch events**, **Watch calendar list** and **Stop notifications**.

Use `primary` for the signed-in person's main calendar. **Query free and busy** returns busy blocks. It does not pick a free time. **Create event** can ask for a Meet link. **Respond to event** sends the guest list you give it, so include everyone who should stay. This app does not create calendars, change sharing, or import events. One list is one page, not the whole calendar.

## What can start a workflow

- **Channel sync**, **Events changed** and **Resource removed**.
- The notice is empty. It does not include the event. **List events** reads what changed. Studio checks the channel it created before it treats the notice as real.
- A watch lasts at most 7 days. Renew it by watching again, then stop the old one.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Google Calendar.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Google Calendar asks for on its own sign-in page.** Choose **Continue to Google Calendar** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Google Calendar opens soon on this server.**, this server cannot sign Google Calendar in yet. If you do not see **Add**, ask an admin to add Google Calendar.

## What it asks for

- See calendars, events, settings and free/busy time this account can already open (`calendar.readonly`). Listing calendars needs this.
- View and edit events on calendars this account can access (`calendar.events`). This alone does not list the person's calendars.
- It does not ask for full calendar access (`https://www.googleapis.com/auth/calendar`).

## Related

- [Gmail](https://falcon.com/docs/app-gmail)
- [Google Drive](https://falcon.com/docs/app-google-drive)
- [Connections](https://falcon.com/docs/connections)