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.
gws-gmail
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.