gws-workflow-email-to-task
Transforms Gmail emails into tasks in Google Tasks. It automates task creation from received messages.
What it does
This tool turns a Gmail email into a Google Tasks entry. It uses the email's subject as the task title and the body as notes.
When to use it
- ✓When you receive an email that needs to become a task.
- ✓To organize your to-dos that start as emails.
- ✓When you want to turn an email reminder into something actionable.
Example of what to ask your AI
“Turn email with ID 'ABC123XYZ' into a task.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You provide the unique ID of a Gmail email. The tool reads the subject and content of that email to create a new task in your Google Tasks.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-workflow-email-to-taskOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-workflow-email-to-task/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
FAQ
What is a 'message-id'?
It's a unique code that identifies each email in Gmail.
Can I choose which task list the task is created in?
Yes, you can specify a different task list than the default using the '--tasklist' option.
Does the tool create the task automatically?
No, it asks for your confirmation before creating the task in Google Tasks.
Details
Original description by the author
Google Workflow: Convert a Gmail message into a Google Tasks entry.
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6288
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
benchmark
Helps your agent measure code speed and performance. It's useful for ensuring things are fast and finding slowness issues.
affaan-m/ECC
content-hash-cache-pattern
Lets your agent use content hashes to cache file processing results. This avoids repeated processing and auto-invalidates the cache when content changes. Useful for speeding up slow tasks.
affaan-m/ECC
parallel-execution-optimizer
Makes your agent speed up complex tasks by breaking them into smaller parts and running them in parallel. It ensures everything is verified at the end.
affaan-m/ECC