gws-workflow-weekly-digest skill: a weekly summary of meetings and unread mail

Lets Claude summarise this week's Google Calendar meetings and your unread Gmail count with the gws tool.

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

gws-workflow-weekly-digest tells Claude how to run gws workflow +weekly-digest. It combines the calendar agenda for the week with a Gmail triage summary, giving this week's meetings plus the unread email count.

The tips say it is read-only and never modifies data. It needs the gws tool installed and signed in, and it tells Claude to read the gws-shared skill first.

Good for

People who start the week by checking calendar and inbox
Managers who want a Monday summary without opening two apps
Developers who already script Google Workspace from the terminal

Install gws-workflow-weekly-digest

Claude Code

Copy this prompt.

Install the gws-workflow-weekly-digest skill in Claude Code. Run this command:

npx skills add https://github.com/googleworkspace/cli --skill gws-workflow-weekly-digest --skill gws-shared

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.

The skill only tells Claude how to call the gws tool, so gws must be installed and signed in on your machine first. gws-shared is installed too because every gws skill tells Claude to read it for sign-in, global flags and safety rules. The README says gws is not an officially supported Google product.

From the vendor's docs. Source.

What's in the skill

When it loads

Google Workflow: Weekly summary: this week's meetings + unread email count.

Sections in SKILL.md

Usage
Flags
Examples
Tips
See Also

Key facts

Author: googleworkspace
Repo: googleworkspace/cli
Installs on skills.sh: 31,933 as of Nov 2, 2026
GitHub stars: 32,038 for the whole googleworkspace/cli repo, Nov 2, 2026
License: Apache-2.0
Last repo commit: Oct 30, 2026
What is inside: 1 file: SKILL.md
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn
Needs: The gws command line tool, installed and signed in to a Google account, plus the gws-shared skill
Official?: The README says gws is not an officially supported Google product

What it includes

Summarises this week's meetings and unread email count
Optional --format: json (default), table, yaml or csv.
Try: “Give me my weekly digest as a table.”
Network · gws workflow +weekly-digest
Choose json, table, yaml or csv output
JSON is the default.
--format
Claude reads this skill first for sign-in and safety rules
SKILL.md opens with a prerequisite note to read ../gws-shared/SKILL.md.
Read · gws-shared prerequisite

From the official docs

Permissions

Low risk

The skill only reads, but your calendar and a mail summary become part of your conversation with Claude.

What it can do

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

Watch out for

Calendar and mail summaries go into your chat
What the command returns is read by Claude and sent to your AI provider as part of the conversation. Do not run it on an account whose mail you cannot share. github.com
gws is an unofficial tool under active development
The README says gws is not an officially supported Google product and that breaking changes are expected before v1.0. Pin a release if you rely on it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	SKILL.md defines no read-only switch. gws-shared lists a --dry-run flag that validates a command locally without calling the API.
Talks to	Google Workspace APIs, called by the gws tool
Sign-in and keys	Sign-in is handled by gws, not the skill. The README says interactive credentials are encrypted at rest, with the key in your OS keyring.
Scopes	Reads this week's Google Calendar events Reads a Gmail triage summary including the unread count Runs the gws command on your machine

Questions

How do I install gws-workflow-weekly-digest?

Use the install box at the top of this page. It installs this skill together with gws-shared. You also need the gws tool installed and signed in, because the skill only tells Claude which gws commands to run.

Does gws-workflow-weekly-digest need an API key?

No API key is named in the skill. It needs a Google sign-in through gws (gws auth login) and, per the README, a Google Cloud project for the OAuth credentials. gws also supports service accounts and a pre-made access token.

Does gws-workflow-weekly-digest work in the Claude app or Codex?

It needs a terminal where the gws tool runs, so Claude Code is the direct fit. The install box has a Codex tab. The Claude app tab is left out because the skill runs a command on your own machine and the README documents no upload route.

Does it read my emails?

The tips say it combines the week's calendar agenda with a Gmail triage summary, and the description gives an unread email count. SKILL.md does not say what the summary lists beyond that.

Can it change my calendar or mailbox?

The skill's tips say it is read-only and never modifies data.

Is gws-workflow-weekly-digest safe?

The skill says it only reads. What it reads becomes part of your chat with your AI provider, so use it only with calendar and mail you are fine sharing there. The gws README says gws is not an officially supported Google product.

How is it different from the standup report?

The weekly digest covers the whole week of meetings plus an unread email count. The standup report covers today's meetings plus open tasks.

Information

updated Nov 2, 2026

Repository: googleworkspace/cli
Folder: skills/gws-workflow-weekly-digest

googleworkspace/cli skills.sh

Sources

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

Show all 5

googleworkspace/cli README · github.com
skills CLI commands · github.com
gws-shared SKILL.md · github.com
gws-workflow-weekly-digest SKILL.md · github.com
skills.sh listing · skills.sh