← Back to Skills Marketplace
Gws Calendar Agenda
by
googleworkspace-bot
· GitHub ↗
· v1.0.13
· MIT-0
839
Downloads
0
Stars
18
Active Installs
14
Versions
Install in OpenClaw
/install gws-calendar-agenda
Description
Google Calendar: Show upcoming events across all calendars.
README (SKILL.md)
calendar +agenda
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
- gws-shared — Global flags and auth
- gws-calendar — All manage calendars and events commands
Usage Guidance
This skill appears to be a thin wrapper around the 'gws' CLI to read Google Calendar events, which is reasonable — but it defers authentication details to a sibling file (../gws-shared/SKILL.md) and suggests running 'gws generate-skills' to create that file. Before installing or invoking the skill: 1) Verify the origin and trustworthiness of the 'gws' binary (how will it be installed?). 2) Inspect ../gws-shared/SKILL.md (or the output of 'gws generate-skills') to see exactly what credentials, files, and filesystem locations are used and what OAuth scopes are requested. 3) Confirm whether credentials are stored locally (and where) or provided via environment variables; if stored, prefer isolated test environments. 4) If you don't want the agent creating files or running auth flows, do not allow it to run the generator and run the CLI manually yourself. If you provide those details, I can re-evaluate and raise confidence.
Capability Analysis
Type: OpenClaw Skill
Name: gws-calendar-agenda
Version: 1.0.13
The skill bundle provides standard instructions for an AI agent to interact with a Google Workspace CLI tool (gws) to list calendar events. The SKILL.md file defines legitimate flags and examples for viewing agendas, and there are no signs of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (Google Calendar agenda) align with the declared requirement: the skill is instruction-only and requires the 'gws' CLI to query calendars. Requiring a Google-related CLI is appropriate for this purpose.
Instruction Scope
The SKILL.md explicitly tells the agent to read ../gws-shared/SKILL.md for auth, global flags, and security rules and to run 'gws generate-skills' if that file is missing. That directs the agent to read or create files outside this skill's directory and to run a generator that may write config and trigger authentication flows. The skill does not detail what the shared file contains or what paths/credentials will be accessed or created.
Install Mechanism
No install spec and no code files — lowest-risk distribution. The skill relies on an existing 'gws' binary on PATH; installing that binary is outside this skill.
Credentials
The skill declares no required environment variables or primary credential, yet refers to a shared auth document and a CLI that will require Google credentials (OAuth tokens, service account keys, or local config). The lack of declared env vars/config paths is a transparency gap: users can't see what secrets or files the skill will actually need or access.
Persistence & Privilege
always:false and no explicit autonomous privilege escalation. However, the instruction to run 'gws generate-skills' if the shared SKILL.md is missing implies the agent may create files or config (persisted credentials) on disk. This is not inherently malicious but should be reviewed for where files are written and what scopes are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-calendar-agenda - After installation, invoke the skill by name or use
/gws-calendar-agenda - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.13
- Bumped skill version from 0.22.4 to 0.22.5 in SKILL.md.
v1.0.12
- Updated version number in SKILL.md from 0.22.3 to 0.22.4.
- No other content or feature changes.
v1.0.11
- Bumped metadata version from 0.22.2 to 0.22.3 in SKILL.md.
- No functional or documentation changes otherwise.
v1.0.10
- Updated version number in SKILL.md from 0.22.1 to 0.22.2.
- No feature or documentation changes; maintenance update only.
v1.0.9
- Updated version metadata from 0.22.0 to 0.22.1 in SKILL.md.
- No functional changes; documentation only.
v1.0.8
- Updated version metadata in SKILL.md from 0.21.2 to 0.22.0.
- No functional or usage changes; documentation update only.
v1.0.7
- Bumped metadata version from 0.21.1 to 0.21.2 in SKILL.md.
- No changes to usage, flags, or documentation content.
v1.0.6
- Updated skill version in metadata from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.5
- Bumped metadata version from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.4
- Bumped skill version to 0.20.0 in metadata.
- No functional or usage changes.
- Documentation/metadata update only.
v1.0.3
- Updated version metadata to 0.19.0 to match new versioning scheme.
- Moved the version field from the root level to the "metadata" section in SKILL.md.
- No behavioral or flag changes; documentation only.
v1.0.2
- Documentation update only: formatting changes in SKILL.md
- No changes to functionality or usage
- Clarified YAML indentation under metadata > requires > bins section
v1.0.1
- Added support for a --timezone flag to override the default Google account timezone.
- Updated usage examples and tips to include and document the new --timezone option.
v1.0.0
Initial release: Display upcoming Google Calendar events across all calendars.
- Supports filtering events by today, tomorrow, this week, or a custom number of days ahead.
- Allows restricting results to a specific calendar by name or ID.
- Read-only; does not modify events.
- Usage instructions and command examples included for easy setup.
Metadata
Frequently Asked Questions
What is Gws Calendar Agenda?
Google Calendar: Show upcoming events across all calendars. It is an AI Agent Skill for Claude Code / OpenClaw, with 839 downloads so far.
How do I install Gws Calendar Agenda?
Run "/install gws-calendar-agenda" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Calendar Agenda free?
Yes, Gws Calendar Agenda is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Calendar Agenda support?
Gws Calendar Agenda is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Calendar Agenda?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.13.
More Skills