# Manage Google Calendar with the gws CLI

Calendar administration often requires precise API methods and parameters. This skill guides Claude, Codex, and Claude Code through Google Calendar operations using the gws CLI.

## Install

```bash
npx skillstore add googleworkspace/gws-calendar
```

## Metadata

- Status: approved
- Slug: googleworkspace-gws-calendar
- Version: 0.23.0
- Author version: 0.23.0
- Skillstore revision: r2
- Version status: valid
- Tree hash: 4794a8b2db7a1cfa2d865ecb957c65860c6ded2b3ff435838ffb856f29db8076
- Author: googleworkspace
- GitHub username: googleworkspace
- License: MIT
- Repository: https://github.com/googleworkspace/cli/tree/main/skills/gws-calendar/
- Ref: 286d37c9c189ddd1aafd3548415fb031d1df79d5
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 82
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/googleworkspace-gws-calendar
- Manifest: https://skillstore.pages.dev/api/skills/googleworkspace-gws-calendar/manifest

## Capabilities

- Guides retrieval and management of calendar lists and calendar metadata.
- Documents methods for creating, reading, updating, importing, moving, listing, and deleting events.
- Covers access control rule creation, inspection, updates, watches, and deletion.
- Supports free and busy queries across selected calendars.
- Documents Calendar settings, colors, resource watches, and channel cleanup.
- Directs users to inspect method schemas before building parameters and request data.

## Use Cases

- Coordinate a personal schedule: Review upcoming events, inspect calendar details, and create or update appointments.
- Plan team availability: Query free and busy data before proposing meeting times across several calendars.
- Administer calendar resources: Inspect access rules, calendar metadata, settings, and change watches for managed calendars.

## Prompt Templates

### Review upcoming events

```
Show my next ten events across all calendars. Inspect the relevant gws schema first, then summarize each date, time, calendar, and location.
```

### Create a calendar event

```
Prepare an event titled [title] on [calendar] from [start] to [end]. Show the proposed details and request confirmation before creating it.
```

### Find a shared meeting time

```
Check availability for [calendars] between [start] and [end]. Suggest three open [duration]-minute times without exposing unrelated event details.
```

### Audit calendar access and watches

```
Inspect access rules and active resource watches for [calendar]. Summarize owners, permissions, and watch scope before proposing any changes.
```

## Limitations

- Requires the gws CLI and valid Google Workspace authentication.
- Depends on the shared skill for authentication, global flags, and security rules.
- Provides a method overview, while detailed parameters must come from gws schema output.
- Destructive operations require careful user review before execution.

## Best Practices

- Inspect the method schema before supplying parameters or request data.
- Confirm calendar identifiers, time zones, and date ranges before changing events.
- Request explicit approval before deleting events, clearing calendars, or changing access rules.

## Anti Patterns

- Do not clear a primary calendar when only one event should be removed.
- Do not expose event details when a free and busy result is sufficient.
- Do not use a service account as the calendar owner when another user should own the calendar.

## Security Audit

- Audited at: 2026-08-05T10:41:59.176\+00:00
- Summary: All 45 external-command findings are false positives caused by Markdown backticks, code fences, and documented gws CLI examples; no Ruby or shell backtick execution exists. All three traversal findings are relative Markdown links to sibling skills, with no filesystem operation or user-controlled path. No prompt injection, social engineering, or data exfiltration intent appears in SKILL.md.

## Stats

- Views: 102
- Downloads: 8
- Favorites: 0
- Popularity score: 0