---

name: gws-calendar-insert version: 1.0.0 description: "Google Calendar: Create a new event." metadata: openclaw: category: "productivity" requires: bins: ["gws"] cliHelp: "gws calendar +insert --help"

calendar +insert

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

create a new event

Usage

gws calendar +insert --summary <TEXT> --start <TIME> --end <TIME>

Flags

| Flag | Required | Default | Description | |------|----------|---------|-------------| | --calendar | — | primary | Calendar ID (default: primary) | | --summary | ✓ | — | Event summary/title | | --start | ✓ | — | Start time (ISO 8601, e.g., 2024-01-01T10:00:00Z) | | --end | ✓ | — | End time (ISO 8601) | | --location | — | — | Event location | | --description | — | — | Event description/body | | --attendee | — | — | Attendee email (can be used multiple times) |

Examples

gws calendar +insert --summary 'Standup' --start '2026-06-17T09:00:00-07:00' --end '2026-06-17T09:30:00-07:00'
gws calendar +insert --summary 'Review' --start ... --end ... --attendee alice@example.com

Tips

• Use RFC3339 format for times (e.g. 2026-06-17T09:00:00-07:00).
• For recurring events or conference links, use the raw API instead.

[!CAUTION] This is a write command — confirm with the user before executing.

See Also

• gws-shared — Global flags and auth
• gws-calendar — All manage calendars and events commands