gws-calendar

Manage Google Calendar calendars, events, and access rules via the gws CLI.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-calendar-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-calendar
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-calendar
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-calendar-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Google Calendar programmatically requires learning the Calendar API's resources, methods, and parameters. This Skill maps the entire Calendar API v3 surface to the gws CLI so an AI agent can create events, list calendars, query free/busy status, and manage sharing rules without writing raw API calls. ## Core Features & Use Cases - Event Management: Create, update, delete, move, and list events, including recurring event instances and quickAdd from plain text. - Calendar Administration: Create secondary calendars, manage calendar lists, and configure ACL sharing rules and user settings. - Availability Queries: Run freebusy queries across multiple calendars to find open meeting slots. - Use Case: Ask the agent to check your free/busy status across all calendars this week, then create a team sync event at the first shared open slot. ## Quick Start Ask the agent to list your upcoming events across all calendars for the next seven days using the gws calendar command.

Frequently Asked Questions about gws-calendar

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

FAQPage Schema
How do I create a Google Calendar event from the command line?

Use gws calendar events insert with the calendar ID and event details, or use the +insert helper command. You can also use events quickAdd to create an event from a plain text string like 'Lunch tomorrow at noon'.

How to check free/busy availability across multiple Google Calendars?

Use gws calendar freebusy query with a list of calendar IDs and a time range. The API returns busy intervals for each calendar, which you can compare to find shared open slots.

Does gws calendar support recurring events?

Yes. The events.instances method returns individual instances of a recurring event, and events.insert supports recurrence rules in the event body. Inspect parameters first with gws schema calendar.events.insert.

How do I share a Google Calendar using the API?

Use the acl resource methods: gws calendar acl insert creates an access control rule granting a user or group a role on the calendar. You can list, patch, update, or delete rules with the other acl methods.

Why can't I move a Google Calendar event to another calendar?

The events.move method only works for default events. Birthday, focusTime, fromGmail, outOfOffice, and workingLocation events cannot be moved between calendars, and only the organizer can perform the move.