recipe-plan-weekly-schedule Skill: Plan Your Calendar Week and Fill Gaps

Reviews your Google Calendar week, finds gaps and adds events to fill them.

Installs: 31.1K; on skills.sh
Stars: 32K; on GitHub
Updated: Oct 2026; last repo commit

recipe-plan-weekly-schedule is a four-step recipe: check this week's agenda, check free/busy for the week, add an event in a gap, then review the updated schedule. It uses the gws program through the gws-calendar service skill. The example adds a Deep Work Block on your own calendar, and its dates are fixed examples, so give the agent your own. Adding events changes your calendar.

Good for

Anyone who wants focus time blocked out for the week
Managers planning their week around meetings
Claude Code or Codex users who already run the gws program

Install recipe-plan-weekly-schedule

Claude Code

Copy this prompt.

Install the recipe-plan-weekly-schedule skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill recipe-plan-weekly-schedule --skill gws-calendar --skill gws-shared -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, gws installed and signed in.

Do the "First" and "Then" methods once before the skills command: they install gws and sign you in. The skills command adds 3 skills (recipe-plan-weekly-schedule, gws-calendar, gws-shared) because recipe-plan-weekly-schedule reads gws-shared first and points to the others in the set. Without gcloud, use the manual OAuth setup in the README. To limit what the sign-in grants, run gws auth login -s calendar so the consent screen lists only those services.

From the vendor's docs. Source.

What's in the skill

When it loads

Review your Google Calendar week, identify gaps, and add events to fill them.

Sections in SKILL.md

Steps

Key facts

Author: googleworkspace organization (repo owner)
Status: Not an officially supported Google product, per the README
License: Apache-2.0
Installs on skills.sh: 31,066 (Nov 2, 2026)
GitHub stars: 32,038 (Nov 2, 2026) (whole repo)
Last commit: Oct 30, 2026
What installs: 1 file, SKILL.md; it bundles no scripts
Needs: the gws program signed in to Google, plus gws-shared and gws-calendar
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
Documented setups: skills CLI, OpenClaw, Gemini CLI extension

What it includes

Shows this week's agenda
Used in step 1 and again in step 4 to review the result.
Network · gws calendar +agenda
Checks free/busy for the week
The example queries the primary calendar.
Network · gws calendar freebusy query
Adds an event in a gap
The example adds a Deep Work Block with a summary, start and end.
Write · gws calendar +insert

From the official docs

Permissions

Low risk

It adds events to your own Google Calendar. Read each command before you approve it.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It adds events to your calendar
The example event has no attendees. Check the time before you approve it, and remove stray events in Calendar. github.com
The example dates are fixed
The commands use January 2025 and January 2026 dates. Tell the agent which week you mean and your time zone. github.com
The project is in active development
The README says to expect breaking changes before v1.0. Re-read the install steps after you update gws. github.com

Technical details

Turning on read-only	No read-only switch in the skill. The gws-shared skill says to prefer --dry-run for destructive operations and to confirm write commands with you.
Talks to	Google Workspace APIs through gws
Sign-in and keys	gws sign-in. The README says credentials are encrypted at rest (AES-256-GCM) with the key kept in your OS keyring.
Scopes	Whatever Google services you grant when you sign in to gws

Questions

What does recipe-plan-weekly-schedule do?

Reviews your Google Calendar week, finds gaps and adds events to fill them.

How do I install recipe-plan-weekly-schedule in Claude Code?

Use the install box above. It adds recipe-plan-weekly-schedule together with gws-calendar, gws-shared in one step. You also need the gws program installed and signed in to Google first, and the box lists both steps.

Does recipe-plan-weekly-schedule work in the Claude app or Codex?

The install box has a Codex tab that uses the skills CLI's Codex target, but the repo README does not list Codex as a supported setup. The README documents no Claude app route, and every command runs the gws program in a terminal, so use Claude Code or another terminal agent.

Does recipe-plan-weekly-schedule need an API key?

No API key. It uses your Google sign-in through gws, and the README says you need a Google Cloud project for the sign-in credentials. gws auth setup can create one if you have the gcloud CLI.

Is recipe-plan-weekly-schedule safe?

It adds events to your own Google Calendar. The example has no attendees, but check the time and the attendee list before you approve any event.

Does it invite other people?

The example event has no attendees, so it only blocks time on your own calendar. If you ask for attendees, invites will go out.

Do the example commands run as written?

Not for your week. Step 2 queries 20 to 25 January 2025 and step 3 inserts an event on 21 January 2026, so the two steps do not even use the same year. Step 1 runs a bare gws calendar +agenda; SKILL.md does not say how far ahead that looks, while the gws-calendar-agenda skill documents --week, --today, --days and --timezone, so ask for --week. The step 3 times have no offset, but gws-calendar-insert documents RFC3339 times with one.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/recipe-plan-weekly-schedule

googleworkspace/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

googleworkspace/cli README · github.com
skills CLI commands · github.com
recipe-plan-weekly-schedule SKILL.md · github.com
gws-shared SKILL.md · github.com
gws-calendar-agenda SKILL.md · github.com
gws-calendar-insert SKILL.md · github.com