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

# Google Calendar

> Connect Google Calendar to view, create, and manage events.

## Connect

1. In Google Cloud, enable the **Google Calendar API** and create OAuth
   credentials for a **Desktop app**.
2. Put the credentials at `~/.arden/gmail_credentials.json`, or import them
   with the setup assistant in **Settings → Integrations**.
3. Open the **Google Calendar** card and click **Connect**. Arden opens a local
   browser consent flow and stores an account-specific token under `~/.arden/`.

Use **Add account** to connect another Google account.

## Manual setup

Use the same credentials file as Gmail:

```bash theme={null}
~/.arden/gmail_credentials.json
```

With the server running, connect and enable Calendar:

```bash theme={null}
curl -X POST http://localhost:6877/google/calendar/connect \
  -H "Authorization: Bearer $ARDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X PATCH http://localhost:6877/config \
  -H "Authorization: Bearer $ARDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integrations":{"calendar":true}}'
```

## Available tools

| Tool                    | Description                         |
| ----------------------- | ----------------------------------- |
| `calendar`              | Search and list events              |
| `create_calendar_event` | Create an event (requires approval) |
| `edit_calendar_event`   | Edit an event (requires approval)   |
| `delete_calendar_event` | Delete an event (requires approval) |

## Troubleshooting

* **API not enabled / 403** – enable the Google Calendar API in the OAuth project's API library.
* **Missing scope** – disconnect and reconnect Google Calendar.
* **Testing app access denied** – add your Google account as an OAuth test user.

## Event-driven automations

Calendar events can trigger automations. For example:

```
Create an automation that triggers 15 minutes before any calendar event.
It should recall memory about the attendees and summarize recent interactions.
```