Gws Workflow Email To Task
Turn a specific Gmail message into a Google Tasks item using gws so action items leave the inbox without manual copy-paste.
Overview
gws-workflow-email-to-task is an agent skill most often used in Operate (also Build integrations, Grow support) that converts a Gmail message by ID into a Google Tasks entry via the gws CLI.
Install
npx skills add https://github.com/googleworkspace/cli --skill gws-workflow-email-to-taskWhat is this skill?
- Requires `--message-id` for the Gmail message to convert
- Maps email subject to task title and snippet to task notes
- Optional `--tasklist` (default @default) targets a specific Google Tasks list
- Creates a new task—skill advises confirming with the user before executing
- Depends on gws-shared for auth, flags, and security rules
- Required flag: --message-id
- Default task list: @default unless --tasklist is set
Adoption & trust: 16.9k installs on skills.sh; 26.9k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
Action items stay buried in Gmail because copying subject and body into Tasks is tedious during inbox triage.
Who is it for?
Solo operators using Google Tasks as their lightweight backlog who want agent-assisted email-to-task conversion with gws already set up.
Skip if: Teams on non-Google task systems, bulk unattended conversions without user confirmation, or workflows needing full email body/HTML preserved as notes.
When should I use this skill?
User wants to convert a specific Gmail message into Google Tasks via `gws workflow +email-to-task --message-id`.
What do I get? / Deliverables
A new Google Tasks item is created with the email subject as title and snippet as notes after you confirm the message ID and target list.
- New Google Tasks entry titled from email subject
- Task notes from Gmail snippet
- CLI confirmation output from gws
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Operate because the skill closes the loop between inbound email and personal task tracking during day-to-day work. Iterate matches triage habits—converting messages into tasks as you process queue—not one-time launch setup.
Where it fits
After reading a vendor email, convert it to a Tasks item with the subject as the title before archiving the thread.
Agent pipeline that lists starred Gmail IDs and asks you to confirm each `+email-to-task` run.
Promote a customer bug report email into a Tasks follow-up while you are solo on support.
How it compares
Use for single-message Gmail→Tasks creation via gws—not a full project-management or multi-label automation suite.
Common Questions / FAQ
Who is gws-workflow-email-to-task for?
Indie builders and agent users on Google Workspace who track work in Google Tasks and want one CLI command per email action item.
When should I use gws-workflow-email-to-task?
During operate inbox triage, when a support or sales email should become a follow-up task, or when wiring build integrations that create Tasks from flagged Gmail IDs.
Is gws-workflow-email-to-task safe to install?
It creates tasks in your Google account—confirm message IDs and task lists before running; review the Security Audits panel on this Prism page for OAuth and write-scope risks.
SKILL.md
READMESKILL.md - Gws Workflow Email To Task
# workflow +email-to-task > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. Convert a Gmail message into a Google Tasks entry ## Usage ```bash gws workflow +email-to-task --message-id <ID> ``` ## Flags | Flag | Required | Default | Description | |------|----------|---------|-------------| | `--message-id` | ✓ | — | Gmail message ID to convert | | `--tasklist` | — | @default | Task list ID (default: @default) | ## Examples ```bash gws workflow +email-to-task --message-id MSG_ID gws workflow +email-to-task --message-id MSG_ID --tasklist LIST_ID ``` ## Tips - Reads the email subject as the task title and snippet as notes. - Creates a new task — confirm with the user before executing. ## See Also - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth - [gws-workflow](../gws-workflow/SKILL.md) — All cross-service productivity workflows commands