Google Workspace Workflow (gws-workflow)
PREREQUISITE: Read the
gws-sharedskill for auth, global flags, and security rules. Individual service skills (gws-drive,gws-gmail,gws-calendar,gws-sheets,gws-tasks,gws-docs) contain per-service command references.
Cross-service productivity workflows using the gws CLI.
gws workflow <resource> <method> [flags]
Built-in Workflow Helpers
| Command | Description |
|---|---|
gws workflow +standup-report |
Today's meetings + open tasks as a standup summary |
gws workflow +meeting-prep |
Prepare for your next meeting: agenda, attendees, and linked docs |
gws workflow +email-to-task |
Convert a Gmail message into a Google Tasks entry |
gws workflow +weekly-digest |
Weekly summary: this week's meetings + unread email count |
gws workflow +file-announce |
Announce a Drive file in a Chat space |
Common Multi-Service Workflows
Email → Task conversion
# 1. Get the email
gws gmail users messages get \
--params '{"userId": "me", "id": "MESSAGE_ID", "format": "full"}'
# 2. Create a task from it
gws tasks tasks insert \
--params '{"tasklist": "TASKLIST_ID"}' \
--json '{"title": "Follow up: [email subject]", "notes": "[email snippet]", "due": "2026-03-20T17:00:00.000Z"}'
Drive file → Chat announcement
# 1. Get file metadata (including sharing link)
gws drive files get \
--params '{"fileId": "FILE_ID", "fields": "id,name,webViewLink"}'
# 2. Send to Chat space
gws chat spaces messages create \
--params '{"parent": "spaces/SPACE_ID"}' \
--json '{"text": "📄 New document ready: [File Name] — https://docs.google.com/..."}'
Calendar event → Doc meeting notes
# 1. Get next event
gws calendar events list \
--params '{"calendarId": "primary", "maxResults": 1, "orderBy": "startTime", "singleEvents": true, "timeMin": "'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'"}'
# 2. Create a meeting notes doc
gws docs documents create \
--json '{"title": "Meeting Notes — [Event Name] — [Date]"}'
# 3. Add agenda section
gws docs documents batchUpdate \
--params '{"documentId": "DOC_ID"}' \
--json '{"requests": [{"insertText": {"location": {"index": 1}, "text": "## Agenda\n\n## Notes\n\n## Action Items\n"}}]}'
Sheets CRM update → Gmail confirmation
# 1. Append deal update to Sheets
gws sheets spreadsheets values append \
--params '{"spreadsheetId": "SHEET_ID", "range": "Deals!A1", "valueInputOption": "USER_ENTERED"}' \
--json '{"values": [["2026-03-14", "Acme Corp", "Proposal Sent", "$50,000"]]}'
# 2. Send confirmation email
gws gmail +send \
--to sales-team@example.com \
--subject "CRM Updated: Acme Corp — Proposal Sent" \
--body "Deal logged in the tracker."
Persona Workflows
Executive Assistant
Manage an executive's schedule, inbox, and communications:
- Standup report:
gws workflow +standup-report - Meeting prep:
gws workflow +meeting-prep - Email triage:
gws gmail +triage - Schedule focus blocks:
gws calendar events insertwith recurring RRULE
Project Manager
Coordinate projects — track tasks, schedule meetings, share docs:
- Log deal/status:
gws sheets spreadsheets values append - Create recurring standups:
gws calendar events insertwithRRULE:FREQ=WEEKLY - Generate project doc from template:
gws docs documents batchUpdate+replaceAllText - Notify team:
gws chat spaces messages create
IT Admin
Administer Workspace — monitor security, manage users:
- Run audit reports:
gws admin reports activities list - Review login events: filter by
applicationName=login - Export user list:
gws admin directory users list
Tips
- Chain multiple
gwscommands with shell variables to pass IDs between steps - Use
jqto extract specific fields from JSON responses - Use
--dry-runon any command before automating it in a scheduled workflow - For recurring automations, wrap
gwscommands in a cron job or GitHub Actions workflow