gws-workflow-email-to-task — Claude Code skill: use and install
This skill turns a selected Gmail message into a Google Tasks entry. Use it when an email needs to become an actionable task.
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a claude-codeWhat gws-workflow-email-to-task does
The skill takes a Gmail message ID and creates a new Google Tasks entry. It uses the email subject as the task title and puts the message snippet into the task notes. The target task list can be set with --tasklist; @default is used when the flag is omitted.
Run gws workflow +email-to-task --message-id to start the workflow. The gws binary is required. Before using the workflow, read ../gws-shared/SKILL.md for authentication, global flags, and security rules. When that file is missing, the source instructions point to gws generate-skills.
Install this skill when an agent needs to turn Gmail messages into Google Tasks entries from a prompt. It creates a new task, so the agent must ask the user for confirmation before execution.
What it helps with
- turn a Gmail message into a Google Tasks entry
- use an email subject as the task title
- save the message snippet as task notes
- send the task to a selected list with
--tasklist
Example prompts for the agent
- Turn the Gmail message with ID `MSG_ID` into a Google Tasks entry.
- After confirmation, create a task from `MSG_ID` in task list `LIST_ID`.
- Run `gws workflow +email-to-task --message-id MSG_ID` after I approve the new task.
How to install gws-workflow-email-to-task
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a claude-code2Manually: put the files in place
~/.claude/skills/gws-workflow-email-to-task/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gws-workflow-email-to-task/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a codex2Manually: put the files in place
.agents/skills/gws-workflow-email-to-task/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a cursor2Manually: put the files in place
.cursor/skills/gws-workflow-email-to-task/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-workflow-email-to-task2Manually: put the files in place
.github/skills/gws-workflow-email-to-task/SKILL.md1Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a gemini-cli2Platform CLI
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-workflow-email-to-taskManually: put the files in place
.devin/skills/gws-workflow-email-to-task/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set95
The whole set →Similar
Questions about gws-workflow-email-to-task
How do I install gws-workflow-email-to-task in Claude Code?
Run npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a claude-code. The skill file is placed at ~/.claude/skills/gws-workflow-email-to-task/SKILL.md.
What does gws-workflow-email-to-task do?
It takes a Gmail message ID and creates a Google Tasks entry. The email subject becomes the title, while the message snippet is used as notes.
What does this skill require?
The gws binary and the instructions in ../gws-shared/SKILL.md are required for authentication, global flags, and security rules. The agent must confirm with the user before creating the task.
Source text
SKILL.md · Apache-2.0
---
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.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
© googleworkspace · Apache-2.0 · googleworkspace/cli