SkillsSKILLS
Productivity

recipe-find-free-time▌

googleworkspace/cli · updated Apr 8, 2026

$npx skills add https://github.com/googleworkspace/cli --skill recipe-find-free-time
summary

Find overlapping free time slots across multiple Google Calendars for scheduling meetings.

  • ›Queries free/busy status for multiple users within a specified time range to identify available meeting windows
  • ›Requires the gws-calendar skill as a dependency
  • ›Integrates with Google Workspace Calendar API to retrieve availability data and create events with attendees in confirmed free slots
skill.md

1d:["$","div",null,{"className":"prose prose-invert max-w-none prose-headings:font-semibold prose-headings:tracking-tight prose-h1:text-4xl prose-h1:mb-2 prose-h2:text-2xl prose-h2:mb-2 prose-h3:text-lg prose-h3:mb-2 prose-p:text-muted-foreground prose-li:text-muted-foreground prose-code:bg-muted prose-code:text-foreground prose-code:px-1 prose-code:py-0.5 prose-code:rounded-sm prose-code:text-sm prose-code:before:content-none prose-code:after:content-none prose-pre:bg-muted prose-pre:text-foreground prose-pre:border prose-pre:border-border prose-pre:rounded-md [&_table]:!border-[color:var(--border)] [&_th]:!border-[color:var(--border)] [&_td]:!border-[color:var(--border)]","dangerouslySetInnerHTML":{"__html":"<h1>Find Free Time Across Calendars</h1>\n<blockquote>\n<p><strong>PREREQUISITE:</strong> Load the following skills to execute this recipe: <code>gws-calendar</code></p>\n</blockquote>\n<p>Query Google Calendar free/busy status for multiple users to find a meeting slot.</p>\n<h2>Steps</h2>\n<ol>\n<li>Query free/busy: <code>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"}]}'</code></li>\n<li>Review the output to find overlapping free slots</li>\n<li>Create event in the free slot: <code>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'</code></li>\n</ol>"}}]