gws-calendar-insertby Google

Google Calendar: Create a new event.

npx skills add https://github.com/googleworkspace/cli --skill gws-calendar-insert
Download ZIPGitHub

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

FlagRequiredDefaultDescription
--calendar—primaryCalendar 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

More skills from Google

gws-groupssettings
by Google
Manage Google Groups settings.
gws-modelarmor-sanitize-response
by Google
Google Model Armor: Sanitize a model response through a Model Armor template.
gws-people
by Google
Google People: Manage contacts and profiles.
gws-reseller
by Google
Google Workspace Reseller: Manage Workspace subscriptions.
gws-shared
by Google
gws CLI: Shared patterns for authentication, global flags, and output formatting.
gws-sheets
by Google
Google Sheets: Read and write spreadsheets.
gws-sheets-append
by Google
Google Sheets: Append a row to a spreadsheet.
gws-sheets-read
by Google
Google Sheets: Read values from a spreadsheet.