gws-workflow-email-to-task

Convert Gmail messages into Google Tasks entries with subject and snippet.

1|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-workflow-email-to-task-cdrguru
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-workflow-email-to-task
Source: https://github.com/cdrguru/portable-agent-kit/tree/main/.agent/skills/gws-workflow-email-to-task
Command: npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-workflow-email-to-task-cdrguru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail messages are often left untracked; this Skill automates turning email content into actionable Google Tasks entries, ensuring nothing falls through the cracks.

Core Features & Use Cases

  • Reads a Gmail message by ID and creates a new Google Task with the email subject as the task title and the snippet as notes.
  • Supports selecting the target task list via the --tasklist flag, defaulting to @default when unspecified.
  • Integrates with the gws framework for authentication, global flags, and security rules to streamline cross-service workflows.

Quick Start

Run the command gws workflow +email-to-task --message-id <ID> to convert a Gmail message into a Google Tasks entry.

Frequently Asked Questions about gws-workflow-email-to-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Gmail messages into Google Tasks entries automatically?

You can convert Gmail messages into Google Tasks entries by running the gws workflow email-to-task command with a specific message ID, which maps the email subject to the task title and snippet to notes.

Can I choose which task list receives the converted email in Google Tasks?

Yes, you can select the target task list using the --tasklist flag when running the email-to-task workflow, which defaults to the @default list if no specific task list is specified.

What do I need to set up before automating email-to-task conversion with Google Workspace?

Automating email-to-task conversion requires the gws framework for authentication and security rules, Gmail access to retrieve messages by ID, and Google Tasks API connectivity to create task entries.

Why does the email-to-task workflow require the gws framework?

The email-to-task workflow requires the gws framework because it provides the necessary authentication, global flags, and security rules to securely manage cross-service communication between Gmail and Google Tasks.

What email content gets transferred when creating a Google Task from a Gmail message?

When creating a Google Task from a Gmail message, the email subject becomes the task title and the message snippet is added as notes, ensuring the actionable context is preserved in the task entry.