recipe-find-free-time
googleworkspace/cli
Query Google Calendar free/busy status across multiple users to find available meeting slots.
What is recipe-find-free-time?
This recipe queries Google Calendar to check free/busy status for multiple users and identifies overlapping availability. Use it when scheduling meetings across team members to find mutually available time slots.
- Query free/busy status for multiple calendar users within a specified time range
- Identify overlapping free time slots across participants
- Create calendar events directly in available slots
- Support batch checking of multiple attendees simultaneously
How to install recipe-find-free-time
npx skills add null --skill recipe-find-free-time- Google Workspace CLI (gws) installed
- gws-calendar skill loaded and configured
- Access to query free/busy status for target calendar users
How to use recipe-find-free-time
- 1.Run gws calendar freebusy query with timeMin, timeMax, and a list of user email IDs
- 2.Review the JSON output to identify overlapping free time blocks
- 3.Select a suitable time slot from the available windows
- 4.Use gws calendar +insert to create the meeting event with attendees and time details
Use cases
- Finding a meeting time that works for 3+ team members without back-and-forth emails
- Scheduling recurring team syncs by checking availability across a date range
- Automating meeting creation once a free slot is identified
- Checking calendar availability before proposing meeting times to stakeholders
- Scheduling coordinators
- Team leads managing multiple calendars
- Administrative assistants
- Anyone automating meeting coordination
recipe-find-free-time FAQ
Use ISO 8601 format with timezone (e.g., 2024-03-18T08:00:00Z). The Z indicates UTC; adjust the time to your target timezone.
Only if you have the appropriate permissions to access their calendar free/busy information through Google Workspace.
The recipe creates the event, but you may need to configure notification settings separately to ensure attendees receive invitations.
The output will show busy blocks for all users. Expand your timeMin/timeMax range or check alternative dates.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: recipe-find-free-time description: "Query Google Calendar free/busy status for multiple users to find a meeting slot." metadata: version: 0.22.5 openclaw: category: "recipe" domain: "scheduling" requires: bins: - gws skills: - gws-calendar
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'
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.