$npx -y skills add googleworkspace/cli --skill gws-calendar-insertGoogle Calendar: Create a new event.
| 1 | # calendar +insert |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | create a new event |
| 6 | |
| 7 | ## Usage |
| 8 | |
| 9 | ```bash |
| 10 | gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME> |
| 11 | ``` |
| 12 | |
| 13 | ## Flags |
| 14 | |
| 15 | | Flag | Required | Default | Description | |
| 16 | |------|----------|---------|-------------| |
| 17 | | `--calendar` | — | primary | Calendar ID (default: primary) | |
| 18 | | `--summary` | ✓ | — | Event summary/title | |
| 19 | | `--start` | ✓ | — | Start time (ISO 8601, e.g., 2024-01-01T10:00:00Z) | |
| 20 | | `--end` | ✓ | — | End time (ISO 8601) | |
| 21 | | `--location` | — | — | Event location | |
| 22 | | `--description` | — | — | Event description/body | |
| 23 | | `--attendee` | — | — | Attendee email (can be used multiple times) | |
| 24 | | `--meet` | — | — | Add a Google Meet video conference link | |
| 25 | |
| 26 | ## Examples |
| 27 | |
| 28 | ```bash |
| 29 | gws calendar +insert --summary 'Standup' --start '2026-06-17T09:00:00-07:00' --end '2026-06-17T09:30:00-07:00' |
| 30 | gws calendar +insert --summary 'Review' --start ... --end ... --attendee alice@example.com |
| 31 | gws calendar +insert --summary 'Meet' --start ... --end ... --meet |
| 32 | ``` |
| 33 | |
| 34 | ## Tips |
| 35 | |
| 36 | - Use RFC3339 format for times (e.g. 2026-06-17T09:00:00-07:00). |
| 37 | - The --meet flag automatically adds a Google Meet link to the event. |
| 38 | |
| 39 | > [!CAUTION] |
| 40 | > This is a **write** command — confirm with the user before executing. |
| 41 | |
| 42 | ## See Also |
| 43 | |
| 44 | - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth |
| 45 | - [gws-calendar](../gws-calendar/SKILL.md) — All manage calendars and events commands |