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