calendar

Manage Google Calendar events, agendas, and availability through the gws CLI.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill calendar-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calendar
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/google-workspace/skills/calendar
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill calendar-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Checking schedules, creating meetings, and coordinating availability in Google Calendar normally requires switching to a browser and clicking through the UI. This Skill lets you perform all of those operations directly from the command line via the gws CLI. ## Core Features & Use Cases - Agenda & Availability: View today's, tomorrow's, or weekly agendas and query free/busy status across multiple calendars. - Event Management: Create events with attendees, Google Meet links, locations, and reminders; update, move, or delete existing events; support for recurring events via RRULE and all-day events. - Calendar Administration: List, create, and delete calendars, and manage sharing through ACL rules. - Use Case: Ask "what's on my calendar today" to get an instant agenda, then create a sprint review with attendees and a Meet link in a single command. ## Quick Start Ask the assistant to show today's agenda or create a calendar event with a title, time, and attendees using the calendar skill.

Frequently Asked Questions about calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my Google Calendar agenda from the command line?

Run gws calendar +agenda with flags like --today, --tomorrow, --week, or --days N to view upcoming events. The helper auto-detects your account timezone, and you can override it with --timezone or filter with --calendar.

How do I create a Google Calendar event with attendees and a Meet link?

Use gws calendar +insert with --summary, --start, and --end in ISO 8601 format, then add --attendee for each guest and --meet to attach a Google Meet link. You can also include --location and --description.

How do I check free/busy availability in Google Calendar?

Query the freebusy API with gws calendar freebusy query, passing a JSON body with timeMin, timeMax, and an items array of calendar IDs. You can check multiple calendars at once to find common free slots.

Can I create recurring events with the gws calendar CLI?

Yes, use the raw events insert API with a recurrence field containing an RRULE string, such as RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR. Include a timeZone field in the start and end objects for correct recurring behavior.

Why does my gws calendar command fail with an auth error?

Exit code 2 indicates an authentication problem. Run which gws && gws auth status to verify the CLI is installed and authenticated; if not, install and configure it from the googleworkspace/cli repository.