skilld
All skills
googleworkspace avatar

/gws-calendar-agenda

@705fb0e
by Google Workspacegoogleworkspace/cli31k stars
1,856

Google Calendar: Show upcoming events across all calendars.

Ask your Agent

Use this Skill: https://skilld.dev/gh/googleworkspace/cli/gws-calendar-agenda

This session only. Nothing lands on disk.

SKILL.md

≈20 tokens always: the name and description. ≈330 when used: this file.

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

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

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

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The 'calendar +agenda' skill is a read-only utility designed to list Google Calendar events using the 'gws' CLI tool. The analysis found no evidence of malicious behavior, unauthorized command execution, or data exfiltration. The skill references a local shared configuration for authentication, following standard security practices. While the skill processes external calendar data which is a theoretical surface for indirect prompt injection, this is inherent to its core functionality and mitigated by its read-only nature.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 705fb0e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Activeupdated 6 months ago

Capability

Other metadata
metadata
{
  "version": "0.22.5",
  "openclaw": {
    "category": "productivity",
    "requires": {
      "bins": [
        "gws"
      ]
    },
    "cliHelp": "gws calendar +agenda --help"
  }
}

Topics

  • CLI
  • google-workspace
  • calendar
  • agenda
  • events
  • gws

README badge

README badge for googleworkspace/cli/gws-calendar-agenda

What it does

Lists upcoming events across all Google Calendars via the gws CLI tool, with filters for date range, specific calendars, and timezone overrides. Use this to view your agenda for today, a specific number of days ahead, or the current week—read-only, never modifies events.

Generated from the current SKILL.md.

Frequently asked

Does this skill modify any events?
No. The skill is read-only and only displays upcoming events across your calendars.
Can I filter events to a specific calendar?
Yes, use the --calendar flag with a calendar name or ID to show events from only that calendar.
What timezone does this use by default?
It defaults to your Google account timezone, but you can override it with the --timezone flag using an IANA timezone string (e.g. America/Denver).
What authentication is required?
You must set up Google Workspace auth via the gws-shared skill, which provides the underlying gws CLI tool and credentials.

Generated from the current SKILL.md. These answers refresh after source changes.