Google Workspace Calendar Insert

Execute Google Workspace Calendar Insert operations: $ARGUMENTS

Prerequisites

• Google Workspace CLI (gws) must be installed
• Authentication configured: Run gws auth status to verify
• Review gws calendar-insert --help for all available commands

Available Resources and Methods

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

• gws-shared — Global flags and auth
• gws-calendar — All manage calendars and events commands

Usage

# List available resources and methods
gws calendar-insert --help

# Inspect method schema before calling
gws schema calendar-insert.<resource>.<method>

# Execute command with arguments
gws calendar-insert $ARGUMENTS

Task

Execute the requested Calendar Insert operation: $ARGUMENTS

1. Verify Prerequisites

   • Check gws is installed: gws --version
   • Verify authentication: gws auth status
   • Review available commands: gws calendar-insert --help

2. Inspect Method Schema

   • Before calling any method, inspect its parameters
   • Use gws schema to understand required fields
   • Review parameter types and constraints

3. Execute Operation

   • Build command with appropriate flags
   • Use --params for query/path parameters
   • Use --json for request body
   • Handle pagination with --max-results or --page-token

4. Error Handling

   • Check command output for errors
   • Review API quotas and rate limits
   • Handle authentication issues
   • Retry transient failures

---

License: Apache License 2.0 Source: Google Workspace CLI Original Skill: gws-calendar-insert