gws-calendar-insert

Original：🇺🇸 English
Translated

Google Calendar: Create a new event.

27.8kinstalls
Sourcegoogleworkspace/cli
Added on

NPX Install

npx skill4agent add googleworkspace/cli gws-calendar-insert

Tags

Translated version includes tags in frontmatter
google-calendargws-clievent-creationcalendar-managementcommand-line-tool

SKILL.md Content

View Translation Comparison →

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

bash
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

bash
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