Recipe Find Free Time

by googleworkspacea3768d0e82adNo licenseListed Oct 8, 2026Updated Oct 8, 2026

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

Instructions onlyProductivity & Workflow
AI-generated overview

Finds a meeting slot by querying Google Calendar free/busy status for several users and creating the event.

What it does
Queries Google Calendar free/busy status for multiple attendees over a given time window using the gws calendar freebusy query command. It then reviews the returned data to identify overlapping free slots and creates a meeting event in the chosen slot with the attendees, start and end times.
When to use it
Use when you need to schedule a meeting across several people's calendars and want to find a time that works for everyone. It suits coordinating a single meeting slot from free/busy data rather than managing recurring events or complex scheduling policies.
Requirements
Requires the gws CLI with the gws-calendar skill loaded, plus authenticated Google Calendar access and network connectivity. Instructions only; no scripts are shipped.

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": "[email protected]"}, {"id": "[email protected]"}]}'
  2. Review the output to find overlapping free slots
  3. Create event in the free slot: gws calendar +insert --summary 'Meeting' --attendee [email protected] --attendee [email protected] --start '2024-03-18T14:00:00' --end '2024-03-18T14:30:00'

Source and attribution

Source:googleworkspace/cliinskills/recipe-find-free-timeat commita3768d0

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal