gws-workflow
googleworkspace/cli
Execute cross-service Google Workspace workflows to automate productivity tasks across Gmail, Calendar, Drive, and Tasks.
What is gws-workflow?
gws-workflow enables you to orchestrate multi-step productivity actions across Google Workspace services. Use it to automate standup reports, meeting prep, email-to-task conversion, weekly digests, and file announcements—combining data from Calendar, Gmail, Drive, and Tasks in a single command.
- Execute workflow methods across Google Workspace services (Gmail, Calendar, Drive, Tasks)
- Generate standup reports from today's meetings and open tasks
- Prepare for meetings with agenda, attendees, and linked documents
- Convert Gmail messages into Google Tasks entries
- Create weekly digests summarizing meetings and unread emails
- Announce Drive files in Chat spaces
How to install gws-workflow
npx skills add null --skill gws-workflow- gws CLI installed and configured
- Authentication set up via gws-shared (see ../gws-shared/SKILL.md)
- Access to Google Workspace services (Gmail, Calendar, Drive, Tasks, Chat)
How to use gws-workflow
- 1.Run `gws workflow --help` to browse available resources and methods
- 2.Use `gws schema workflow.<resource>.<method>` to inspect required parameters and types
- 3.Build your command with `gws workflow <resource> <method>` plus `--params` or `--json` flags
- 4.Execute the workflow to trigger the cross-service action
Use cases
- Generate a daily standup summary from calendar and task data before team meetings
- Automatically prepare meeting context by pulling attendees, agenda, and related documents
- Convert important emails into actionable tasks in Google Tasks
- Send weekly team digests with meeting summaries and email statistics
- Share newly created Drive files with team members via Chat
- Knowledge workers managing multiple Google Workspace services
- Team leads preparing standup reports and meeting summaries
- Project managers converting communications into tracked tasks
- Anyone automating cross-service productivity workflows
gws-workflow FAQ
It integrates Gmail, Google Calendar, Google Drive, Google Tasks, and Google Chat to enable multi-service automation.
No. Authentication is handled by gws-shared. Ensure you've read ../gws-shared/SKILL.md and run `gws generate-skills` if needed.
Run `gws workflow --help` to see all resources and methods, then use `gws schema workflow.<resource>.<method>` to inspect parameters.
Yes. The CLI-based design allows integration into shell scripts, cron jobs, and other automation tools.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-workflow description: "Google Workflow: Cross-service productivity workflows." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws workflow --help"
workflow (v1)
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws workflow <resource> <method> [flags]
Helper Commands
| Command | Description |
|---|---|
+standup-report | Today's meetings + open tasks as a standup summary |
+meeting-prep | Prepare for your next meeting: agenda, attendees, and linked docs |
+email-to-task | Convert a Gmail message into a Google Tasks entry |
+weekly-digest | Weekly summary: this week's meetings + unread email count |
+file-announce | Announce a Drive file in a Chat space |
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws workflow --help
# Inspect a method's required params, types, and defaults
gws schema workflow.<resource>.<method>
Use gws schema output to build your --params and --json flags.
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.