# Google Calendar

Manages Google Calendar calendars and events from the command line.

- Repository: https://github.com/googleworkspace/cli (32044 stars)
- Category: Business
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add googleworkspace/cli --skill gws-calendar -g -a claude-code -y`
Codex: `npx skills add googleworkspace/cli --skill gws-calendar -g -a codex -y`
Cursor: `npx skills add googleworkspace/cli --skill gws-calendar -g -a cursor -y`
Gemini CLI: `npx skills add googleworkspace/cli --skill gws-calendar -g -a gemini-cli -y`

## Description

Google Calendar: Manage calendars and events.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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`](../gws-calendar-insert/SKILL.md) | create a new event |
| [`+agenda`](../gws-calendar-agenda/SKILL.md) | 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.

The rest: https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-calendar/SKILL.md