Find Free Time Across Calendars
Check several people's Google Calendar availability and book a shared meeting slot.
- 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”
Install in 3 steps
- 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
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
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.