Recipe Find Free Time

Automates the tedious dance of finding meeting times across multiple Google Calendar users by querying free/busy status and identifying open slots. You feed it a time range and list of attendees, it returns when everyone's actually available, then helps you book the slot. Saves you from the usual back-and-forth email chains or manually cross-referencing multiple calendars. The recipe walks through the specific gws commands for querying availability and creating the actual calendar event. Most useful for scheduling across teams or external meetings where you need to respect everyone's existing commitments without the guesswork.

skills.sh installs: 31.5K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill recipe-find-free-time --agent claude-code

Installs into .claude/skills of the current project.

Files

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

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"}]}'
Review the output to find overlapping free slots
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'

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly