Recipe Find Free Time
Find overlapping free slots across Google Calendars with gws freebusy, then book a meeting in that window.
Overview
recipe-find-free-time is an agent skill most often used in Build (also Grow and Operate) that queries Google Calendar free/busy for several users and books a meeting in a shared open slot.
Install
npx skills add https://github.com/googleworkspace/cli --skill recipe-find-free-timeWhat is this skill?
- Three-step recipe: freebusy query, overlap review, calendar event insert
- Requires gws binary and prerequisite gws-calendar skill loaded first
- JSON freebusy payload with timeMin, timeMax, and multiple attendee calendar IDs
- Creates events with summary, attendees, and start/end via gws calendar +insert
- OpenClaw recipe metadata v0.22.5 under scheduling domain
- Three documented steps from freebusy query to event insert
- Recipe metadata version 0.22.5
Adoption & trust: 16k installs on skills.sh; 26.9k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need a reliable way to see when several people are free on Google Calendar and create the invite without re-explaining API steps each time.
Who is it for?
Indie operators standardizing gws-based scheduling recipes inside Claude Code, Cursor, or similar agents.
Skip if: Teams not on Google Workspace/gws, or meetings that need room resources, timezone politics, or complex recurrence without extending the recipe.
When should I use this skill?
Need to query Google Calendar free/busy for multiple users to find a meeting slot and create the event.
What do I get? / Deliverables
After loading gws-calendar, the agent runs freebusy, picks an overlap, and inserts a calendar event with attendees in that window.
- Freebusy JSON result for listed calendar IDs
- Created calendar event with summary, attendees, and start/end times
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Scheduling automation is implemented when wiring Google Workspace into your agent stack; the recipe is the canonical integration artifact even though PMs use it daily. Integrations is correct because the flow depends on gws CLI, gws-calendar skill, and Calendar API insert—not app frontend code.
Where it fits
Wire the freebusy-plus-insert flow into your agent after installing gws and gws-calendar.
Book customer or partner calls quickly as your pipeline grows without leaving the agent.
How it compares
Fixed gws CLI recipe—not a full calendar admin skill or Microsoft Outlook integration.
Common Questions / FAQ
Who is recipe-find-free-time for?
Solo builders using the Google Workspace CLI who want a repeatable agent recipe for multi-person scheduling.
When should I use recipe-find-free-time?
While building gws automations, during growth when meeting load increases, or in daily ops when you need fast cross-calendar slot finding on Google Calendar.
Is recipe-find-free-time safe to install?
It issues calendar reads and writes via gws; review Security Audits on this page and scope OAuth tokens to least privilege before production use.
Workflow Chain
Requires first: gws calendar
SKILL.md
READMESKILL.md - Recipe Find Free Time
# 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'`