Skip to content
Get packs

Find Free Time Across Calendars

Check several people's Google Calendar availability and book a shared meeting slot.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

Once installed, the agent can look up when several people are busy or free on Google Calendar over a given time window, spot an open time that works for everyone, and create a calendar event for that slot with the attendees added. It relies on the companion gws command-line tool and the gws-calendar skill to actually talk to Google Calendar.

Great for

  • Team leads or assistants scheduling meetings across several colleagues' calendars
  • People who already use the gws command-line tool with Google Workspace and want a quick scheduling helper

Skip it if

  • People without access to the calendars involved, since free/busy lookups need permission to view them
  • Anyone who wants the agent to book meetings without reviewing the proposed slot, because it creates events that invite real attendees and the skill does not describe a confirmation step

Try asking

  • “Find a 30-minute slot tomorrow afternoon when user1@company.com and user2@company.com are both free”
  • “Check free/busy for my three teammates on March 18 between 8am and 6pm and suggest overlaps”
  • “Book a 30-minute meeting with the team at 2pm on March 18 once we confirm it is free”
Step-by-step guide: how to use Find Free Time Across CalendarsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    recipe-find-free-time.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip recipe-find-free-time.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip recipe-find-free-time.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent explicit start and end times with a time zone so the free/busy query covers the right window
  • Ask the agent to show proposed slots and wait for your approval before it creates the event
  • Confirm the gws tool is authenticated with an account that is allowed to read the other calendars

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.