recipe-find-free-time

Query Google Calendar free/busy status for multiple users to identify available meeting slots.

30.3k|1.8k|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/googleworkspace/cli --skill recipe-find-free-time-googleworkspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recipe-find-free-time
Source: https://github.com/googleworkspace/cli/tree/main/skills/recipe-find-free-time
Command: npx skills add https://github.com/googleworkspace/cli --skill recipe-find-free-time-googleworkspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users find a suitable meeting time by checking the free/busy status across multiple Google Calendars, streamlining the scheduling process.

Core Features & Use Cases

  • Multi-user Free/Busy Query: Checks availability for specified attendees within a given time range.
  • Slot Identification: Helps identify overlapping free periods for all attendees.
  • Event Creation: Facilitates the creation of a new event once a suitable slot is found.
  • Use Case: A project manager needs to schedule a 30-minute sync with three team members. This Skill can quickly find a common 30-minute window when everyone is available.

Quick Start

Find a free slot between 9 AM and 5 PM on March 18th, 2024, for [email protected] and [email protected].

Frequently Asked Questions about recipe-find-free-time

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find common available meeting slots across multiple Google Calendars?

To find common available meeting slots, you can query the free/busy status across multiple Google Calendars within a specified time range to identify overlapping free periods for all attendees.

What is the best way to check team availability before scheduling a group sync?

Checking team availability involves querying the free/busy status of all attendees within a given time range, allowing you to quickly identify overlapping free periods suitable for a group sync.

Do I need any specific tools to check free/busy status for scheduling meetings?

Yes, checking free/busy status requires the gws CLI and the gws-calendar skill to be installed and configured, as these handle the underlying calendar queries and execution.

Can I create a calendar event automatically after finding a free slot?

Yes, once a suitable free slot is identified by checking attendee availability, the Skill facilitates the creation of a new calendar event for that specific time window.

Does this approach support querying availability for large groups within specific time ranges?

Yes, it supports multi-user free/busy queries by checking availability for specified attendees within a given time range, suitable for finding overlapping slots for multiple users.

Why does querying calendar availability require setting a specific time range?

Querying calendar availability requires a specified time range to efficiently check free/busy status and identify overlapping free periods, preventing errors from scanning unbounded or infinite schedules.