
Description
Google Calendar: Create a new event.
SKILL.md
calendar +insert
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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) |
--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
- gws-shared — Global flags and auth
- gws-calendar — All manage calendars and events commands
More skills from the cli repository
View all 95 skillsgws-admin-reports
generate Google Workspace audit and usage reports
Jul 12AuditGoogle WorkspaceLogsReportinggws-calendar
manage Google Calendar events and schedules
Jul 12Google CalendarGoogle WorkspaceSchedulinggws-calendar-agenda
show upcoming Google Calendar events
Jul 12Google CalendarGoogle WorkspaceMeetingsgws-chat
manage Google Chat spaces and messages
Jul 12Google WorkspaceMessaginggws-chat-send
send messages to Google Chat spaces
Jul 12Google WorkspaceMessaginggws-classroom
manage Google Classroom rosters and coursework
Jul 12EducationGoogle Workspace
More from Google Workspace
View publishergws-docs
read and write Google Docs
cli
Jul 12DocumentsGoogle DocsGoogle Workspacegws-docs-write
append text to Google Docs
cli
Jul 12DocumentsGoogle DocsGoogle WorkspaceWritinggws-drive
manage files in Google Drive
cli
Jul 12File StorageGoogle DriveGoogle Workspacegws-drive-upload
upload files to Google Drive
cli
Jul 12File StorageFile UploadsGoogle DriveGoogle Workspacegws-events
subscribe to Google Workspace events
cli
Jul 12AutomationGoogle WorkspaceNotifications