skills.rest
oresttokovenko
oresttokovenkoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

recipe-find-free-time

Queries Google Calendar free/busy status across multiple users to find meeting slots.

Updated Nov 9, 2023
Search Tags:#google calendar#scheduling#availability#meeting#freebusy#calendar api#gws
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-find-free-time-oresttokovenko
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recipe-find-free-time
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/recipe-find-free-time
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill recipe-find-free-time-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating meetings across multiple people's calendars requires manually checking each person's availability, which is slow and error-prone. This Skill automates the process by querying Google Calendar free/busy data for several users at once and identifying overlapping free slots. ## Core Features & Use Cases - Multi-User Free/Busy Query: Query the Google Calendar freebusy API for multiple attendees in a single request using the gws CLI. - Slot Identification: Review the returned busy intervals to find overlapping free time windows across all participants. - Event Creation: Create a calendar event with all attendees directly in the identified free slot. - Use Case: You need to schedule a 30-minute sync between two colleagues next week. Run the free/busy query for both calendars, spot a shared opening on Monday afternoon, and insert the meeting invite in one command. ## Quick Start Ask the assistant to find a free 30-minute slot next week for [email protected] and [email protected] using Google Calendar and create the meeting.

Frequently Asked Questions about recipe-find-free-time

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check free/busy status for multiple Google Calendar users?▼

Use the gws calendar freebusy query command with a JSON body containing a time range and a list of calendar IDs. The response returns busy intervals for each user, which you compare to find shared free slots.

How to schedule a meeting in Google Calendar from the command line?▼

Run gws calendar +insert with flags for summary, attendees, start, and end times. This creates the event and adds each attendee directly from the terminal without opening the Calendar web UI.

What do I need installed to query Google Calendar availability?▼

You need the gws CLI binary installed and the gws-calendar skill loaded as a prerequisite. The gws tool handles authentication and API calls to Google Calendar on your behalf.

Does the freebusy query work for calendars outside my organization?▼

The freebusy API only returns availability for calendars you have permission to view. External users who have not shared their calendar free/busy information will not return usable availability data.

Why does my freebusy query return no availability data?▼

This usually happens when the calendar IDs are incorrect, the users have not shared their calendars with you, or the time range uses an invalid format. Verify the email addresses and use ISO 8601 timestamps for timeMin and timeMax.

Related Skills

Explore More Product & Management Skills→
vikingokftvikingokft

recipe-share-event-materials

Share Google Drive files with Google Calendar event attendees via the Google Workspace API.

Official
Intermediate
vikingokftvikingokft

persona-event-coordinator

Plan and manage events with scheduling, invitations, and logistics.

Official
Intermediate
cdrgurucdrguru
1

recipe-find-free-time

Query Google Calendar free/busy data to identify overlapping free slots.

Community
Intermediate
temple-slopetemple-slope

recipe-find-free-time

Identify overlapping free time slots across multiple Google Calendar calendars.

Community
Intermediate