gws-calendar

Google Calendar API access for managing calendars, events, and sharing rules. Covers 10+ API resources including events, calendars, ACL rules, calendar lists, free/busy queries, and user settings Supports event operations: create, read, update, delete, import, move between calendars, and query recurring instances Includes calendar management: create secondary calendars, update metadata, clear primary calendars, and manage sharing access Provides helper commands for quick event creation ( +insert ) and viewing upcoming events across all calendars ( +agenda ) Requires Google Workspace authentication via the shared gws CLI tool; use gws schema to inspect method parameters before execution

INSTALLATION
npx skills add https://github.com/googleworkspace/cli --skill gws-calendar
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

$2a

  • delete — Deletes an access control rule.
  • get — Returns an access control rule.
  • insert — Creates an access control rule.
  • list — Returns the rules in the access control list for the calendar.
  • patch — Updates an access control rule. This method supports patch semantics.
  • update — Updates an access control rule.
  • watch — Watch for changes to ACL resources.

calendarList

  • delete — Removes a calendar from the user's calendar list.
  • get — Returns a calendar from the user's calendar list.
  • insert — Inserts an existing calendar into the user's calendar list.
  • list — Returns the calendars on the user's calendar list.
  • patch — Updates an existing calendar on the user's calendar list. This method supports patch semantics.
  • update — Updates an existing calendar on the user's calendar list.
  • watch — Watch for changes to CalendarList resources.

calendars

  • clear — Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.
  • delete — Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.
  • get — Returns metadata for a calendar.
  • insert — Creates a secondary calendar.

The authenticated user for the request is made the data owner of the new calendar.

Note: We recommend to authenticate as the intended data owner of the calendar. You can use domain-wide delegation of authority to allow applications to act on behalf of a specific user. Don't use a service account for authentication. If you use a service account for authentication, the service account is the data owner, which can lead to unexpected behavior.

  • patch — Updates metadata for a calendar. This method supports patch semantics.
  • update — Updates metadata for a calendar.

channels

  • stop — Stop watching resources through this channel

colors

  • get — Returns the color definitions for calendars and events.

events

  • delete — Deletes an event.
  • get — Returns an event based on its Google Calendar ID. To retrieve an event using its iCalendar ID, call the events.list method using the iCalUID parameter.
  • import — Imports an event. This operation is used to add a private copy of an existing event to a calendar. Only events with an eventType of default may be imported.

Deprecated behavior: If a non-default event is imported, its type will be changed to default and any event-type-specific properties it may have will be dropped.

  • insert — Creates an event.
  • instances — Returns instances of the specified recurring event.
  • list — Returns events on the specified calendar.
  • move — Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved.
  • patch — Updates an event. This method supports patch semantics.
  • quickAdd — Creates an event based on a simple text string.
  • update — Updates an event.
  • watch — Watch for changes to Events resources.

freebusy

  • query — Returns free/busy information for a set of calendars.

settings

  • get — Returns a single user setting.
  • list — Returns all user settings for the authenticated user.
  • watch — Watch for changes to Settings resources.

Discovering Commands

Before calling any API method, inspect it:

# Browse resources and methods

gws calendar --help

# Inspect a method's required params, types, and defaults

gws schema calendar.<resource>.<method>

Use gws schema output to build your --params and --json flags.

BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card