---
id: googleworkspace/cli/recipe-find-free-time
version: "cf2f723d"
license: Apache-2.0
install: manual
updated: 2026-07-22
---

# recipe-find-free-time — This recipe queries Google Calendar's free/busy status across multiple users to identify shared availability windows. It retrieves busy/free data for a specified time range, then helps you spot overlapping open slots where all attendees can meet.

Publisher: googleworkspace · Stars: 30031 · Updated: 2026-07-22

Install (manual): `git clone https://github.com/googleworkspace/cli`

## SKILL.md

# 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'`



[View on SkillFed](https://skillfed.io/googleworkspace/cli/recipe-find-free-time) · [View on GitHub](https://github.com/googleworkspace/cli)