googleworkspace avatar

Gws Calendar Insert

Clean Google Calendar event creation through the gws CLI tool. Takes the essential details (title, start/end times in RFC3339 format) and optional extras like location, description, attendees, and Google Meet links. The write command confirmation is smart since you don't want to accidentally spam calendars. Time zone handling works as expected, and the multiple attendee flag saves you from JSON wrangling. Requires the gws binary and proper Google Workspace auth setup first. Good for automation scripts or when you want calendar management without opening a browser.

skills.sh installs
49.5K
GitHub stars
32.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add googleworkspace/cli --skill gws-calendar-insert --agent claude-code

Installs into .claude/skills of the current project.

Files

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)
--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

Sponsors

Details

Repository
github.com/googleworkspace/cli
Categories
CLI & Terminal, Office & Documents

More from googleworkspace/cli

All 113
1googleworkspace avatargws-gmail-triagegoogleworkspace/cliGmail: Show unread inbox summary (sender, subject, date).48.2Kskills.sh installs
2googleworkspace avatargws-sheets-appendgoogleworkspace/cliGoogle Sheets: Append a row to a spreadsheet.48Kskills.sh installs
3googleworkspace avatargws-tasksgoogleworkspace/cliGoogle Tasks: Manage task lists and tasks.46.3Kskills.sh installs
4googleworkspace avatargws-slidesgoogleworkspace/cliGoogle Slides: Read and write presentations.42.9Kskills.sh installs
5googleworkspace avatargws-meetgoogleworkspace/cliManage Google Meet conferences.42.2Kskills.sh installs
6googleworkspace avatargws-gmail-readgoogleworkspace/cliGmail: Read a message and extract its body or headers.42.1Kskills.sh installs