gws-calendar-insert

googleworkspace/cli

Create a new Google Calendar event with attendees, location, and optional Google Meet link.

What is gws-calendar-insert?

This skill creates a new event in Google Calendar with required start/end times and summary. Use it when you need to schedule meetings, standups, or other calendar events programmatically with optional attendees and video conferencing.

Create events with title, start time, and end time
Add event location and description
Invite multiple attendees by email
Automatically generate and attach a Google Meet video conference link
Target specific calendar (defaults to primary)

How to install gws-calendar-insert

npx skills add null --skill gws-calendar-insert

Prerequisites

gws CLI installed and configured
Google Workspace authentication set up (see gws-shared skill)
User has permission to create events on the target calendar

Claude Code

Cursor

Windsurf

Cline

How to use gws-calendar-insert

1.Run gws calendar +insert with --summary, --start, and --end flags (required)
2.Optionally add --location, --description, --attendee (multiple times), or --meet flags
3.Use RFC3339 format for times (e.g., 2026-06-17T09:00:00-07:00)
4.Confirm the command with the user before executing (write operation)

Use cases

Good for

Schedule a team standup meeting with attendees and Google Meet link
Create a calendar event for a code review session with location details
Add a meeting to the primary calendar with multiple invitees
Generate calendar events from automation workflows or scripts

Who it's for

Developers automating calendar workflows
Team leads scheduling recurring meetings
Automation engineers integrating calendar management into tools

gws-calendar-insert FAQ

What time format should I use?

Use RFC3339 format, e.g., 2026-06-17T09:00:00-07:00. ISO 8601 with timezone offset is required.

Can I add multiple attendees?

Yes, use the --attendee flag multiple times, once per email address.

How do I add a Google Meet link?

Use the --meet flag; it automatically generates and attaches a video conference link to the event.

Which calendar does the event go to by default?

The primary calendar. Use --calendar with a specific calendar ID to target a different calendar.

Do I need special permissions?

You need Google Workspace authentication configured (gws-shared) and permission to create events on the target calendar.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: gws-calendar-insert description: "Google Calendar: Create a new event." metadata: version: 0.22.5 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

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