# Recipe Find Free Time

> Queries Google Calendar free/busy status for multiple users to find a meeting slot and create an event.

- Skill: `vikingokft/recipe-find-free-time` (Agent Skill)
- Install (CLI): `npx skillmds add vikingokft/recipe-find-free-time`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vikingokft/recipe-find-free-time/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity, Email & Calendar
- Tags: Freebusy, Google Calendar, Gws Calendar, Meeting Scheduling
- Author: vikingokft (https://skillmd.com/u/vikingokft)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/vikingokft/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'`