recipe-block-focus-time
googleworkspace/cli
Create recurring focus time blocks on Google Calendar to protect deep work hours.
What is recipe-block-focus-time?
This recipe automates the creation of recurring focus time blocks on Google Calendar, marking them as busy to prevent scheduling conflicts. Use it to establish consistent protected time for deep work across your calendar.
- Creates recurring focus time blocks on Google Calendar
- Sets blocks as opaque (busy) to prevent meeting scheduling
- Configures weekly recurrence across weekdays (Monday–Friday)
- Includes customizable start/end times and timezone support
- Verifies focus blocks appear in your calendar agenda
How to install recipe-block-focus-time
npx skills add null --skill recipe-block-focus-time- Google Workspace CLI (gws) installed
- gws-calendar skill loaded and authenticated
How to use recipe-block-focus-time
- 1.Load the gws-calendar skill if not already installed
- 2.Run the calendar events insert command with your desired focus time parameters (start time, end time, timezone, recurrence days)
- 3.Customize the JSON payload to set your preferred focus block duration and frequency
- 4.Execute the command to create the recurring event
- 5.Verify the focus block appears in your calendar agenda using gws calendar +agenda
Use cases
- Establish a daily 9–11 AM deep work block every weekday
- Protect afternoon focus time from 2–4 PM for concentrated work
- Create recurring "no-meeting" windows for creative or analytical tasks
- Set up multiple focus blocks at different times for different project phases
- Ensure focus time is visible to colleagues as unavailable
- Knowledge workers and developers needing uninterrupted focus time
- Engineering and product teams managing deep work schedules
- Anyone using Google Calendar for time management
- Teams coordinating availability across shared calendars
recipe-block-focus-time FAQ
Yes, modify the start and end dateTime values in the JSON payload. For example, change "09:00:00" to "14:00:00" for afternoon focus time.
Edit the BYDAY parameter in the recurrence rule. Use MO,TU,WE,TH,FR for weekdays, or specify custom days like MO,WE,FR for specific days only.
Yes, the transparency field is set to "opaque" (busy), which marks the time as unavailable in your calendar and prevents others from booking over it.
This recipe creates one recurring pattern. For multiple different focus blocks, run the command multiple times with different time ranges and recurrence rules.
Specify your local timezone in the dateTime fields (e.g., America/New_York, Europe/London, America/Los_Angeles). Ensure it matches your calendar's timezone for accuracy.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: recipe-block-focus-time description: "Create recurring focus time blocks on Google Calendar to protect deep work hours." metadata: version: 0.22.5 openclaw: category: "recipe" domain: "scheduling" requires: bins: - gws skills: - gws-calendar
Block Focus Time on Google Calendar
PREREQUISITE: Load the following skills to execute this recipe:
gws-calendar
Create recurring focus time blocks on Google Calendar to protect deep work hours.
Steps
- Create recurring focus block:
gws calendar events insert --params '{"calendarId": "primary"}' --json '{"summary": "Focus Time", "description": "Protected deep work block", "start": {"dateTime": "2025-01-20T09:00:00", "timeZone": "America/New_York"}, "end": {"dateTime": "2025-01-20T11:00:00", "timeZone": "America/New_York"}, "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"], "transparency": "opaque"}' - Verify it shows as busy:
gws calendar +agenda
Related skills
More from googleworkspace/cli and the wider catalog.
recipe-bulk-download-folder
List and download all files from a Google Drive folder in bulk.
recipe-cancel-and-notify
Delete a Google Calendar event and send a cancellation email via Gmail.
recipe-collect-form-responses
Retrieve and review responses from a Google Form.
recipe-compare-sheet-tabs
Compare data across two Google Sheets tabs to identify differences and changes.
recipe-copy-sheet-for-new-month
Duplicate a Google Sheets template tab for a new month of tracking.
recipe-create-classroom-course
Create Google Classroom courses and invite students via command line.