gws-workflow-email-to-task
googleworkspace/cli
Convert Gmail messages into Google Tasks entries with a single command.
What is gws-workflow-email-to-task?
This skill automates the process of turning emails into actionable tasks in Google Tasks. Use it when you want to quickly capture an email as a task without manual copying or formatting.
- Extracts email subject as task title
- Uses email snippet as task notes
- Creates tasks in specified task list (defaults to @default)
- Requires Gmail message ID as input
- Supports custom task list selection
How to install gws-workflow-email-to-task
npx skills add null --skill gws-workflow-email-to-task- Google Workspace CLI (gws) installed and configured
- Valid Gmail message ID
- Google Tasks API access via gws authentication
- Read gws-shared/SKILL.md for auth and security setup
How to use gws-workflow-email-to-task
- 1.Identify the Gmail message ID you want to convert
- 2.Run: gws workflow +email-to-task --message-id <ID>
- 3.Optionally specify a task list with --tasklist <LIST_ID> (defaults to @default)
- 4.Confirm the task creation when prompted
- 5.Verify the task appears in your Google Tasks list
Use cases
- Convert important emails into your task list for follow-up
- Quickly capture action items from incoming messages
- Organize email-based requests as structured tasks
- Batch convert multiple emails into a task workflow
- Productivity-focused professionals
- Gmail power users
- Teams using Google Workspace
- Anyone managing tasks across email and task lists
gws-workflow-email-to-task FAQ
The message ID is available in Gmail's URL or via the Gmail API. You can typically access it through the gws CLI or Gmail interface.
Yes, use the --tasklist flag with the task list ID. If omitted, tasks are created in the @default task list.
The skill extracts the email subject as the task title and the email snippet as task notes.
Yes, the skill prompts for confirmation before executing the conversion to prevent accidental task creation.
You must have Google Workspace CLI (gws) installed and authenticated. See gws-shared/SKILL.md for detailed auth setup.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-workflow-email-to-task description: "Google Workflow: Convert a Gmail message into a Google Tasks entry." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws workflow +email-to-task --help"
workflow +email-to-task
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Convert a Gmail message into a Google Tasks entry
Usage
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
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 — Global flags and auth
- gws-workflow — All cross-service productivity workflows commands
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.