--- title: Google Calendar summary: Connect a Google Calendar account so your AI agents can check availability, find open slots, create and reschedule events, and manage calendars under permissions you control. category: integrations slug: googlecalendar --- ## What Google Calendar in Kronos lets your agents do Once a Google Calendar account is connected to Kronos, your agents can — within the permissions you grant — work with your schedule the same way you would: **Read actions** (available when an agent has "Read only" or higher): - List your calendars (your primary calendar plus any shared or secondary ones). - Open a specific calendar and read its details. - List events on a calendar for a given day or date range. - Find a specific event by keyword, title, or attendee. - Find open time slots across your calendars for scheduling. - Check when you are busy or free over a period (a free/busy lookup). - Expand a recurring event into its individual instances. - Read your calendar settings (such as your default time zone). - Get the current date and time so events land in the right time zone. - See who has access to a calendar. **Write actions** (available only when an agent has "Read and write"): - Create a new event, with guests, location, time, and a video link. - Quickly add an event from a short phrase like "Lunch with Ana Friday at 1pm". - Update or reschedule an existing event. - Move an event to a different calendar. - Delete an event. - Remove a guest from an event. - Create a new calendar or duplicate an existing one. - Update or delete a calendar. - Clear every event from a calendar. - Add a calendar to your list or update an entry on it. - Change who has access to a calendar. You decide which agent gets which level, and you can switch any permission off in one click without disconnecting the account. ## Connecting Google Calendar 1. Open Kronos → **Connect** in the sidebar → **Applications** tab. 2. Click the **Google Calendar** card to open the detail dialog, then click the green **Connect** button. 3. You land on Google's screen — pick the Google account whose calendar you want to connect. 4. Confirm the chosen account on Google's summary screen. 5. Review the list of actions Kronos will be allowed to do (see events, create and edit events, manage calendars). Leave the boxes checked unless you specifically want to disable a category — some actions stop working when a box is unchecked. 6. Continue, and you are sent back to Kronos at the **Already connected** tab with the new Google Calendar entry pre-selected. You can connect more than one Google Calendar account — for example a work account and a personal one. Each appears as its own connection with its own name. ## Telling connections apart The management page shows the connected account's address right under the "Google Calendar" title (for example, `you@yourcompany.com`). That is how you and Kronos identify which account a connection represents. If you connect more than one account, each appears with its own address. You can also add a short personal note next to it ("Work", "Family Calendar", "Bookings") to scan a long list faster. The note is yours only; agents always identify the account by its underlying address and ID, not by the note. ## Giving an agent access On the Google Calendar management page click **+ Add AI Agent**, pick the agent from the dropdown, then choose: - **Off** — the agent cannot touch this calendar. - **Read only** — the agent can list calendars, read events, check your availability, and find free slots, but cannot create, change, move, or delete anything. - **Read and write** — the agent can do all of the above plus create, reschedule, move, and delete events and manage calendars. The same controls are available inside the AI Agent editor — scroll to the **Connected Apps** section. ## Fine-grained overrides Inside the permissions modal (the gear icon next to a Google Calendar account in the agent editor or on the management page) you'll see the full list of actions grouped into **Read tools** and **Write tools**. Toggle individual actions on or off to override the preset. Common combinations: - **Availability assistant**: preset Read only, no overrides. The agent can answer "when am I free Thursday?" and find open slots, but cannot book anything. - **Booking agent**: preset Read only, override `Create event` and `Quick add event` ON. The agent can read your calendar and add new events, but cannot move or delete existing ones. - **Scheduler without deletions**: preset Read and write, override `Delete event` and `Clear calendar` OFF. The agent can create and reschedule, but can never wipe events. - **Full assistant**: preset Read and write, no overrides. Click Save to apply. Changes take effect on the next message the agent processes. ## Multiple Google Calendar accounts on the same agent If an agent has access to two or more Google Calendar accounts (for example Work and Personal), it picks which account to use on each action based on context. When a request is ambiguous ("add a meeting Friday afternoon"), the agent will ask which calendar to use. You can cut ambiguity by turning the agent's access to one account off, or by renaming the connections to obviously distinct labels ("Work Calendar" vs "Personal Calendar"). ## When something goes wrong - **"Needs reconnect"** badge — Google revoked or expired the connection. Open `/app/connect`, click Google Calendar, and walk through Connect again. Your per-agent permissions are preserved. - **Agent says "I can't create events"** — that agent's preset is Off or Read only without the `Create event` override. Open the permissions modal and adjust. - **Agent says the connected app is temporarily unavailable** — Google or the connection had a transient hiccup. Ask the user to retry in a moment. If it persists, check the management page for a "Needs reconnect" badge. - **Times look off by a few hours** — make sure the agent has the `Get current date and time` read action available so it can resolve your time zone before scheduling. ## Privacy Kronos does NOT store the contents of your calendar. Each time an agent uses a Google Calendar action, it fetches just-in-time through the connection, uses what it needs to complete the task, and discards the result. The audit log records that the action happened (which agent, which action, when, and whether it succeeded), but not your event details. When you disconnect Google Calendar or cancel your Kronos subscription, the connection and all per-agent permissions are deleted immediately.