gws-calendar

Original：🇺🇸 English

Translated

Google Calendar: Manage calendars and events.

50.7kinstalls

Sourcegoogleworkspace/cli

Added on2026-03-05

NPX Install

npx skill4agent add googleworkspace/cli gws-calendar

SKILL.md Content

View Translation Comparison →

calendar (v3)

PREREQUISITE: Read
../gws-shared/SKILL.md
for auth, global flags, and security rules. If missing, run
gws generate-skills
to create it.

bash

gws calendar <resource> <method> [flags]

Helper Commands

Command	Description
`+insert`	create a new event
`+agenda`	Show upcoming events across all calendars

API Resources

acl

```
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: