Labsco
googleworkspace logo

gws-calendar-insert

✓ Official★ 29,425

by Google · part of googleworkspace/cli

Google Calendar: Create a new event.

🔥🔥✓ VerifiedFreeQuick setup
#email#automation#calendar#git#maps#security
🧰 Not standalone. This skill ships with googleworkspace/cli and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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

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)
--meet——Add a Google Meet video conference link

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
gws calendar +insert --summary 'Meet' --start ... --end ... --meet

Tips

  • Use RFC3339 format for times (e.g. 2026-06-17T09:00:00-07:00).
  • The --meet flag automatically adds a Google Meet link to the event.

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

See Also