Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

gws-calendar-agenda — Claude Code skill: what it does, how to install

Displays upcoming events across all Google calendars inside your agent. Useful for checking today's, tomorrow's, or weekly schedules without leaving the editor.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-calendar-agenda -a claude-code
Open on GitHub

What gws-calendar-agenda does

The skill executes gws calendar +agenda to pull event data from Google Calendar. It checks all connected calendars by default. You can filter results with --calendar using a specific name or ID. Range flags include --today, --tomorrow, --week, and --days.

This tool is read-only. It never modifies or deletes entries. Output defaults to your Google account timezone, but --timezone lets you change it. You need the gws binary and auth configured through gws-shared.

Use this to check your agenda without context switching. It cannot create meetings. Because it lacks write permissions, managing events requires the broader gws-calendar skill.

What it helps with

  • view today's or tomorrow's events in the terminal
  • filter agenda entries by calendar name or ID
  • inspect upcoming days using an alternative timezone
  • output weekly schedules in a structured table

Example prompts for the agent

  • Show today's events from Google Calendar
  • gws calendar +agenda --week --format table
  • Show my schedule for the next 3 days from the Work calendar

How to install gws-calendar-agenda

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill gws-calendar-agenda -a claude-code

2Manually: put the files in place

~/.claude/skills/gws-calendar-agenda/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-calendar-agenda/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about gws-calendar-agenda

How to install gws-calendar-agenda in Claude Code?

Run npx skills add googleworkspace/cli --skill gws-calendar-agenda -a claude-code in your terminal. You will also need the gws CLI installed.

What does gws-calendar-agenda do?

It pulls upcoming Google Calendar events for today, tomorrow, this week, or a custom number of days. By default, it queries all calendars in your account.

Can this skill create or edit calendar events?

No, it works in read-only mode and never modifies events. Modifying schedule entries requires the full gws-calendar toolset.

Source text

SKILL.md · Apache-2.0
---
name: gws-calendar-agenda
description: "Google Calendar: Show upcoming events across all calendars."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws calendar +agenda --help"
---

# calendar +agenda

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

Show upcoming events across all calendars

## Usage

```bash
gws calendar +agenda
```

## Flags

| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--today` | — | — | Show today's events |
| `--tomorrow` | — | — | Show tomorrow's events |
| `--week` | — | — | Show this week's events |
| `--days` | — | — | Number of days ahead to show |
| `--calendar` | — | — | Filter to specific calendar name or ID |
| `--timezone` | — | — | IANA timezone override (e.g. America/Denver). Defaults to Google account timezone. |

## Examples

```bash
gws calendar +agenda
gws calendar +agenda --today
gws calendar +agenda --week --format table
gws calendar +agenda --days 3 --calendar 'Work'
gws calendar +agenda --today --timezone America/New_York
```

## Tips

- Read-only — never modifies events.
- Queries all calendars by default; use --calendar to filter.
- Uses your Google account timezone by default; override with --timezone.

## See Also

- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
- [gws-calendar](../gws-calendar/SKILL.md) — All manage calendars and events commands

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor