Labsco
googleworkspace logo

recipe-find-free-time

โœ“ Officialโ˜… 29,425

by Google ยท part of googleworkspace/cli

Query Google Calendar free/busy status for multiple users to find a meeting slot.

๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup
๐Ÿงฐ Not standalone. This skill ships with googleworkspace/cli and only works together with that tool โ€” install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates โ€” you don't need to read it to use the skill, but it's here to audit before installing.

Find Free Time Across Calendars

PREREQUISITE: Load the following skills to execute this recipe: gws-calendar

Query Google Calendar free/busy status for multiple users to find a meeting slot.

Steps

  1. Query free/busy: gws calendar freebusy query --json '{"timeMin": "2024-03-18T08:00:00Z", "timeMax": "2024-03-18T18:00:00Z", "items": [{"id": "user1@company.com"}, {"id": "user2@company.com"}]}'
  2. Review the output to find overlapping free slots
  3. Create event in the free slot: gws calendar +insert --summary 'Meeting' --attendee user1@company.com --attendee user2@company.com --start '2024-03-18T14:00:00' --end '2024-03-18T14:30:00'