googleworkspace avatar

Gws Calendar Insert

googleworkspace/cli
20.2k

This skill enables users to create new events in Google Calendar via a command-line interface, supporting key options like event title, start and end times, location, description, and attendees. It is designed for both casual users and developers who want to automate calendar management, offering features such as ISO 8601 time formatting and the ability to handle multiple attendees. Suitable for anyone needing quick, programmatic event scheduling within Google Workspace.

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

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

GitHub Owner

Owner: googleworkspace

Files

gws-shared

gws-calendar

SKILL.md


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

FlagRequiredDefaultDescription
--calendarprimaryCalendar ID (default: primary)
--summaryEvent summary/title
--startStart time (ISO 8601, e.g., 2024-01-01T10:00:00Z)
--endEnd time (ISO 8601)
--locationEvent location
--descriptionEvent description/body
--attendeeAttendee 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