gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
What it does
This feature shows your upcoming appointments and events scheduled in Google Calendar. It can display events for today, tomorrow, the current week, or a specific number of days into the future.
When to use it
- ✓When you want to know what's on for today.
- ✓When you need to plan your week.
- ✓When you want to see events from a specific calendar.
Example of what to ask your AI
“Show me my events for the next 3 days.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
It accesses your Google Calendar account and searches for upcoming events. You can ask to see events for today, tomorrow, the week, or a custom period.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-calendar-agendaOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-calendar-agenda/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
FAQ
Can I see events from specific calendars?
Yes, you can use the '--calendar' option to filter and view events from a specific calendar, such as 'Work' or 'Personal'.
Can I see events from other time zones?
Yes, you can use the '--timezone' option to view your events in another time zone if needed.
Does this feature change my events?
No, this feature only displays your events and does not make any changes to them.
Details
Original description by the author
Google Calendar: Show upcoming events across all calendars.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6251
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
gws-chat-send
Helps your agent send messages to a space in Google Chat. It's useful for communicating with teams.
googleworkspace/cli
Similar skills
operator-approval-loop
Makes your agent manage message sending with human approval. It ensures important messages are reviewed before being sent.
affaan-m/ECC
discernment-nudge
Has your agent add follow-up questions after giving an important answer. It's useful for ensuring you think carefully about advice or plans before acting.
anthropics/skills
interview-me
Asks questions to understand exactly what you need. Ensures the agent grasps your real need before starting work.
addyosmani/agent-skills