---
id: googleworkspace/cli/gws-workflow-email-to-task
version: "b47943a4"
license: Apache-2.0
install: manual
updated: 2026-07-22
---

# gws-workflow-email-to-task — Turn emails into tasks by extracting the subject line as the task title and message snippet as notes. Supports custom task lists and requires confirmation before creating entries.

Publisher: googleworkspace · Stars: 30031 · Updated: 2026-07-22

Install (manual): `git clone https://github.com/googleworkspace/cli`

## SKILL.md

# 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


[View on SkillFed](https://skillfed.io/googleworkspace/cli/gws-workflow-email-to-task) · [View on GitHub](https://github.com/googleworkspace/cli)