Gws Calendar

What Is This?

Overview

Gws Calendar is a command-line interface skill built on top of the Google Workspace CLI tool, providing direct terminal access to Google Calendar resources and events. It allows developers, system administrators, and power users to manage calendars and calendar events programmatically without opening a browser or interacting with the Google Calendar web interface. The skill follows the pattern of gws calendar <resource> <method> [flags], making it consistent with other Google Workspace CLI commands.

The tool connects to the Google Calendar API v3 under the hood, exposing its full range of capabilities through a structured command syntax. Users can create, read, update, and delete calendars and events, manage attendees, configure recurring events, and handle calendar sharing permissions, all from within a terminal session. This makes it particularly useful for automation scripts, CI/CD pipelines, and developer workflows that require calendar integration without manual intervention.

Authentication and global configuration are handled by the shared gws authentication layer, which means credentials and security settings are managed centrally. Before using this skill, the gws-shared prerequisites must be in place, ensuring that API access tokens and OAuth flows are properly configured.

Who Should Use This

• Software developers who need to automate calendar event creation as part of deployment workflows or release management processes
• DevOps engineers who want to schedule maintenance windows, on-call rotations, or infrastructure events directly from scripts
• System administrators managing shared team calendars across an organization and needing bulk operations or scripted updates
• Data engineers building pipelines that log scheduled job runs or processing windows as calendar events for visibility

Why Use It?

Problems It Solves

• Manual repetition: Creating the same recurring events or calendar entries by hand across multiple calendars is time-consuming and error-prone. Gws Calendar allows these operations to be scripted and executed consistently.
• Lack of automation integration: Standard calendar interfaces do not integrate with shell scripts or CI/CD pipelines. This skill bridges that gap by exposing calendar operations as CLI commands.
• Bulk operations: Updating or deleting many events at once through a web interface is impractical. Command-line access enables batch processing with loops and conditionals.
• Audit and reproducibility: Scripted calendar management produces repeatable, version-controllable workflows, making it easier to audit what was scheduled and when.

Core Highlights

• Full access to Google Calendar API v3 resources and methods
• Consistent CLI syntax shared across all Google Workspace CLI skills
• Supports creating, listing, updating, and deleting calendars and events
• Handles event metadata including attendees, time zones, and recurrence rules
• Integrates with existing shell scripts and automation pipelines
• Centralized authentication through the shared gws credential layer
• Scriptable output suitable for parsing and chaining with other commands

How to Use It?

Basic Usage

To get started, confirm the tool is available and review available subcommands:

gws calendar --help

List all calendars accessible to the authenticated account:

gws calendar calendarList list

Create a new calendar event on a specific calendar:

gws calendar events insert --calendarId="primary" --summary="Deploy v2.4.0" --start.dateTime="2024-06-15T10:00:00Z" --end.dateTime="2024-06-15T11:00:00Z"

Specific Scenarios

Scheduling a maintenance window: A DevOps engineer can insert a blocking event on a shared infrastructure calendar to notify the team of a planned outage window, passing the calendar ID and time range as flags directly in a deployment script.

Listing upcoming events for a report: A script can call gws calendar events list --calendarId="primary" --timeMin="2024-06-01T00:00:00Z" to retrieve upcoming events and pipe the output into a reporting tool or log file.

Real-World Examples

gws calendar events list --calendarId="primary" --maxResults=10 --orderBy=startTime

gws calendar events delete --calendarId="primary" --eventId="abc123xyz"

When to Use It?

Use Cases

• Automating release or deployment event creation in shared team calendars
• Scripting on-call schedule entries from a roster management system
• Bulk-deleting outdated events from a project calendar at sprint close
• Logging scheduled batch job windows as calendar events for operational visibility
• Creating recurring meeting templates programmatically for new project onboarding
• Integrating calendar event creation into CI/CD pipeline notifications
• Managing calendar sharing permissions across teams via scripted administration

Important Notes

Requirements

• The gws binary must be installed and available in the system PATH
• Authentication must be configured through the gws-shared prerequisite before any calendar commands will succeed
• A valid Google Workspace or personal Google account with Calendar API access is required
• Run gws generate-skills if the shared skill configuration file is missing