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

# Calendar

> Your Google Calendar: a week page, free time, and agent tools that add or change events only with your yes.

Calendar shows your Google Calendar in Archetype and lets the agent read it. It is on by default. It appears in the sidebar as **Calendar**. For turning plugins on and off, see [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

## Connect it

Connect Google Calendar in **Manage → Connections → Apps**. Calendar holds no key of its own; it reaches Google through that connection.

With several Google accounts connected, their events show together. A new event goes to the first account's primary calendar; a change, a removal or an answer goes to the account the event is on.

## The page

The page shows your personal primary calendar, week by week.

* **Edit an event**: title, place, description, all-day, date and times. Guests and the calendar stay as they are. A new time is confirmed first.
* **Repeat**: every day, every week on chosen weekdays, every month on its date or every year, until a day or a number of times. Repeating events are marked ↻. Changing or removing one asks which occurrences: this one, all, or this and the following.
* **Find a time**: free stretches of at least the length you ask, 09:00 to 18:00 on weekdays, for up to 31 days ahead. Events you declined, or marked free, do not count as busy.
* **Other calendars**: switches turn your other calendars on or off on the page. Their events are read only; every change from the page goes to the primary calendar.

If the event changed in Google since you opened it, saving stops and tells you to refresh first.

## What the agent can do

| Tool | What it does | Asks you |
| - | - | - |
| `calendar_events` | Reads events | No |
| `calendar_free_time` | Finds free time, and with `attendees`, when those people are busy too | No |
| `calendar_add_event` | Adds an event, inviting up to 50 people | Every time |
| `calendar_update_event` | Changes only the fields it names | Every time |
| `calendar_propose_event` | Leaves an appointment it found for you to add | No: you decide in **Notifications** |

Adding and changing ask you every time, even in `yolo`; with no one there to answer, they are refused. See [Approvals](https://docs.archetype.ing/en/use/approvals.md).

## Notices and events

* **Proposed appointments** wait in **Notifications** with **Add** and **Dismiss**. **Add** creates the event.
* **`calendar.starting`**: sent before an event on your own calendar starts. All-day events and events you declined are not told. A [trigger](https://docs.archetype.ing/en/use/automations.md) can wake on it. It carries the title, start, minutes to go, attendees, place and meeting link, never the description.

## Settings

In **Manage → Plugins → Calendar**:

| Setting | Default | What it does |
| - | - | - |
| **Minutes before a meeting** | 10 | How long before an event `calendar.starting` is sent (1 to 120) |

## Profile it offers

**Meeting prep** (read only): before each meeting, a few lines on who is in it, what you last talked about with them (mail, messages, notes, recordings), what is open between you and what to bring or decide. It wakes on `calendar.starting`. Start one from **Manage → Profiles → New profile**.

## Works with

People's timeline, the phone's Now, the day's brief and Recordings read your events through Calendar. With Calendar off (`"plugins": { "calendar": false }` in the [config](https://docs.archetype.ing/en/reference/config.md)), there is no Calendar page, the agent has no calendar tools, and those go on without your events.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.