gws-calendar-insert

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 
5create a new event
6 
7## Usage
8 
9```bash
10gws 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
29gws calendar +insert --summary 'Standup' --start '2026-06-17T09:00:00-07:00' --end '2026-06-17T09:30:00-07:00'
30gws calendar +insert --summary 'Review' --start ... --end ... --attendee alice@example.com
31gws 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…