recipe-find-free-time
Lets your agent check the availability of multiple people in Google Calendar. It finds free slots to schedule meetings.
What it does
This tool helps find free times in multiple people's calendars to schedule meetings. It checks everyone's availability and suggests a time when all are free.
When to use it
- ✓When you need to schedule a meeting with colleagues.
- ✓To find a time that works for everyone in a group.
- ✓When organizing an event that depends on multiple people's availability.
Example of what to ask your AI
“Find a free slot for me, John, and Mary tomorrow between 2 PM and 5 PM.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool accesses the calendars of the indicated people and looks for blocks of time where everyone is available. Then, it can help create the event at that found time.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill recipe-find-free-timeOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/recipe-find-free-time/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
- 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"}]}' - Review the output to find overlapping free slots
- 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'
FAQ
Do I need access to other people's calendars?
No, the tool only queries the 'free' or 'busy' status from the calendars, without seeing the details of the appointments.
Can I use this to find times across different companies?
Currently, the tool is most effective within the same organization or if calendars are set up to share availability information.
What happens if no one is free?
The tool will inform you that a common time slot could not be found within the requested period.
Details
Original description by the author
Query Google Calendar free/busy status for multiple users to find a meeting slot.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6324
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
carrier-relationship-management
Manages relationships with carriers. It helps negotiate freight rates, evaluate performance, and build transportation strategies.
affaan-m/ECC
cost-tracking
Tracks and reports agent token usage and costs. It's useful for efficiently controlling spending and budgets.
affaan-m/ECC
plan-canvas
Opens plans and artifacts in a browser window for you to comment on. It makes giving visual feedback on needed changes easier.
affaan-m/ECC