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-workflow-file-announce
Announce a Google Drive file in a Chat space with a single command.
gws-workflow-meeting-prep
Prepare for your next meeting with agenda, attendees, and linked docs from Google Calendar.
gws-workflow-standup-report
Generate today's standup summary from Google Calendar meetings and open tasks.
gws-workflow-weekly-digest
Get a weekly summary of your meetings and unread email count from Google Workspace.
persona-content-creator
Create, organize, and distribute content across Google Workspace with integrated Docs, Drive, Gmail, Chat, and Slides.
persona-customer-support
Manage customer support tickets, respond to inquiries, and escalate issues using Gmail, Sheets, Chat, and Calendar.