Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill gws-workflow-email-to-task -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/gws-workflow-email-to-task/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gws-workflow-email-to-task/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

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

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor