gws-workflow Skill: Standups, Meeting Prep and Digests From Google Workspace

Gives your coding assistant five Google Workspace routines such as a standup report and meeting prep, run through the gws tool.

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

gws-workflow is an index for five gws workflow commands: a standup report, meeting prep, email to task, a weekly digest and a file announcement. It is the entry point. The detail for each command lives in its own small skill, which the install box adds with it.

You need the gws command line tool and a Google sign-in. Two of the commands change things in your account: one creates a Google Tasks entry and one sends a Chat message.

Good for

Managers and engineers who want a standup summary from today's meetings and open tasks
Anyone who wants a weekly summary of meetings and unread email
People who turn emails into Google Tasks entries
Teams that announce Drive files in Google Chat

Install gws-workflow

Claude Code

Copy this prompt.

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

npm install -g @googleworkspace/cli

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 18+.

Do steps 1 to 3 in order. The skill only gives your assistant instructions. The gws tool does the work, and it needs a Google sign-in. The gws-workflow file is only an index, so the command above also adds its five helper skills. gws auth setup needs the gcloud CLI to create a Google Cloud project for you; without gcloud, use the manual setup in the README. The README also lists a GitHub Releases download, Homebrew and cargo as other ways to get gws.

From the project README. Source.

What's in the skill

When it loads

Google Workflow: Cross-service productivity workflows.

Sections in SKILL.md

Helper Commands
Discovering Commands

Key facts

Author: googleworkspace org (the README says it is not an officially supported Google product)
Repo: googleworkspace/cli
Installs on skills.sh: 33,854 as of 2026-11-02
GitHub stars: 32,038 for the whole googleworkspace/cli repo, 2026-11-02
License: Apache-2.0 (README)
Last commit to the repo: 2026-10-30
What is inside: 1 file (SKILL.md). It links to five helper skills and the separate gws-shared skill.
Needs: The gws command line tool (Node.js 18+ for the npm route), a Google account and a Google Cloud project for sign-in
Also installs: gws-shared plus the five helper skills the index links to: gws-workflow-standup-report, gws-workflow-meeting-prep, gws-workflow-email-to-task, gws-workflow-weekly-digest and gws-workflow-file-announce
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn (2026-11-02)

What it includes

Today's meetings and open tasks as a standup summary
Reads your calendar and tasks and gives you a summary for a standup. Output is JSON by default; --format table, yaml or csv also work.
Try: “Give me my standup report for today.”
Network · +standup-report
Agenda, attendees and linked docs for your next meeting
Shows the next upcoming event with attendees and description. Its own SKILL.md says it is read-only and never modifies data. --calendar picks a calendar other than your primary.
Try: “Prep me for my next meeting.”
Network · +meeting-prep
Turns a Gmail message into a Google Tasks entry
Uses the email subject as the task title and the snippet as notes. It creates a new task, and its SKILL.md says to confirm with the user first. --tasklist picks a list other than the default.
Try: “Turn Gmail message MSG_ID into a task.”
Write · +email-to-task
This week's meetings plus your unread email count
Combines the week's calendar agenda with a Gmail triage summary. Its own SKILL.md says it is read-only and never modifies data.
Try: “Give me a weekly digest.”
Network · +weekly-digest
Announces a Drive file in a Google Chat space
Looks up the file name in Drive and sends an announcement to a Chat space. Its SKILL.md calls it a write command that sends a Chat message. --message sets your own text.
Try: “Announce Drive file FILE_ID in spaces/ABC123.”
Write · +file-announce
Shows the parameters of a workflow method
The index tells the assistant to inspect a method with gws schema before it builds a call, and to browse with gws workflow --help.
Read · gws schema workflow.<resource>.<method>

From the official docs

Permissions

Medium risk

What it can do

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

Watch out for

One helper sends a Chat message
gws workflow +file-announce posts to a Google Chat space. Check the space name and the file before you approve. github.com
One helper creates tasks
gws workflow +email-to-task adds a new Google Tasks entry from an email. Its SKILL.md says to confirm with the user first. github.com
Summaries read your calendar and mail
The standup report, meeting prep and weekly digest read meetings, tasks and an unread-mail count, and that text goes to your AI provider. Skip them on accounts you do not want to share. github.com
Setup installs a global npm package
The npm route downloads the gws binary from GitHub Releases. The README also says to expect breaking changes before v1.0, so pin what you rely on. github.com
You need a Google Cloud project to sign in
gws uses OAuth credentials from your own Google Cloud project. If the consent screen is unverified, Google caps the scopes you can pick, so choose individual services with gws auth login -s. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode for the whole set. The standup-report, meeting-prep and weekly-digest helpers say they are read-only. The other two helpers can write.
Talks to	Google Workspace APIs, called by the gws tool. Anything the assistant reads from your account goes to your AI provider as part of the chat
Sign-in and keys	gws encrypts saved credentials (AES-256-GCM) with a key in your OS keyring, or in ~/.config/gws/.encryption_key when the file backend is chosen.
Scopes	Whatever Google permissions you approve when you run gws auth login

Questions

What does gws-workflow do?

It points your assistant at five gws workflow commands: standup report, meeting prep, email to task, weekly digest and file announce. Each command has its own helper skill with the flags and tips.

How do I install gws-workflow?

Use the install box at the top of this page and run all three steps. The command adds gws-shared and the five helper skills together with gws-workflow, because the index alone only links to them. You also need the gws tool and a Google sign-in.

Does it need a Google Cloud project or an API key?

It needs a Google Cloud project, because gws signs in with OAuth credentials from one, according to the README. gws auth setup can create it if you have the gcloud CLI. Without gcloud, follow the README's manual setup.

Is gws-workflow safe to use?

Two of the five commands change things. +email-to-task creates a Google Tasks entry and +file-announce sends a Google Chat message. The standup report, meeting prep and weekly digest helpers say they are read-only. Approve each run, and check the Chat space name before an announcement.

Can I use it in the Claude app or Claude.ai?

The README does not document that. The skills tell the assistant to run gws shell commands, so they fit an assistant that can run commands on a machine where gws is installed and signed in, such as Claude Code or Codex.

Which Google services does it touch?

The helper descriptions mention Calendar, Tasks, Gmail, Drive and Chat. Pick those services when you sign in, for example with gws auth login -s and a list of services.

Information

updated Nov 2, 2026

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

googleworkspace/cli skills.sh

Sources

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

Show all 8

googleworkspace/cli README · github.com
gws-workflow SKILL.md · github.com
skills CLI commands · github.com
gws-shared SKILL.md · github.com
gws-workflow-meeting-prep SKILL.md · github.com
gws-workflow-email-to-task SKILL.md · github.com
gws-workflow-weekly-digest SKILL.md · github.com
gws-workflow-file-announce SKILL.md · github.com