---
name: gog-calendar
description: "Google Calendar operations through gog."
---

# Google Calendar

<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->

Use `gog` for Google Calendar operations. Read `../gog/SKILL.md` first for shared auth,
output, safety, and live-write rules.

## Safe start

```bash
gog auth list --check --json --no-input
gog schema calendar --json
gog --readonly --account user@example.com calendar events --today --json --wrap-untrusted
```

- Select the account explicitly with `--account`.
- Use `--json --wrap-untrusted` for agent-readable Google content.
- Use `--readonly` when the task must not mutate Google data.
- Use `--no-input` in automation and `--dry-run` before supported writes.
- Confirm the exact account, object, and mutation before any write or delete.

## Commands

| Command | Purpose |
| --- | --- |
| `acl` | List calendar ACL |
| `alias` | Manage calendar aliases |
| `calendars` | List calendars |
| `changed` | List most recently changed events (including deletions) |
| `colors` | Show calendar colors |
| `conflicts` | Find busy-time overlaps across calendars |
| `create` | Create an event |
| `create-calendar` | Create a new secondary calendar |
| `delete` | Delete an event |
| `delete-calendar` | Delete an owned secondary calendar |
| `event` | Get event |
| `events` | List events from a calendar or all calendars |
| `focus-time` | Create a Focus Time block |
| `freebusy` | Get free/busy |
| `move` | Move an event to another calendar |
| `out-of-office` | Create an Out of Office event |
| `propose-time` | Generate URL to propose a new meeting time (browser-only feature) |
| `raw` | Dump raw Google Calendar API response as JSON (Events.Get; lossless; for scripting and LLM consumption) |
| `respond` | Respond to an event invitation |
| `search` | Search events |
| `subscribe` | Add a calendar to your calendar list |
| `team` | Show events for Workspace group members (service account, direct token, or ADC) |
| `time` | Show server time |
| `unsubscribe` | Remove a calendar from your calendar list |
| `update` | Update an event |
| `users` | List workspace users (use their email as calendar ID) |
| `working-location` | Set working location (home/office/custom) |

Run `gog calendar <command> --help` for flags and `gog schema calendar <command> --json`
for the machine-readable contract. Do not guess command syntax.