gws-calendar-agenda

What This Skill Does

The gws-calendar-agenda skill is a specialized agentic capability designed for the OpenClaw platform, enabling users to interact with their Google Calendar data directly through the command line or via natural language prompts. It serves as a read-only interface that aggregates events from all connected Google calendars, providing a streamlined view of upcoming commitments. Whether you are managing professional meetings, personal appointments, or project deadlines, this skill allows for quick, context-aware queries about your schedule without requiring you to switch windows to the browser-based calendar interface.

Installation

To integrate this skill into your OpenClaw environment, ensure you have first initialized the shared workspace configuration by referring to ../gws-shared/SKILL.md. Once the authentication and global security prerequisites are met, run the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-calendar-agenda. This process fetches the necessary binaries and dependencies from the source repository, effectively registering the gws calendar +agenda command to your agent.

Use Cases

This skill is indispensable for professionals who need to maintain situational awareness of their time. Use cases include: quickly checking if you are free for an impromptu meeting, reviewing your daily workload as soon as you start your shift, planning your work week by visualizing upcoming calendar blocks, or filtering for specific project-based calendars to focus your attention. It acts as a bridge between your calendar data and your automated workflows.

Example Prompts

1. "OpenClaw, what is on my schedule for the rest of today?"
2. "Show me all upcoming meetings for the next three days across my Work calendar."
3. "Do I have any events scheduled for this coming week? Please format the output as a table."

Tips & Limitations

This skill is strictly read-only, ensuring that your existing schedule remains protected from accidental modification by the agent. By default, it performs a comprehensive query across all calendars, which is excellent for a holistic view but can be filtered using the --calendar flag if you have many calendars. For the best experience, ensure your Google workspace permissions are correctly configured in gws-shared. Note that the command relies on your active authentication session; if the command fails, verify your auth token status via gws auth status.