gws-gmail-read

Read Gmail messages by ID and return body or headers in text or JSON.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/cellarwood/figurio --skill gws-gmail-read-cellarwood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-read
Source: https://github.com/cellarwood/figurio/tree/main/skills/gws-gmail-read
Command: npx skills add https://github.com/cellarwood/figurio --skill gws-gmail-read-cellarwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading Gmail messages and extracting their body or headers is time-consuming and error-prone when done manually across multiple messages.

Core Features & Use Cases

  • Read a Gmail message by ID and retrieve either the body or headers (From, To, Subject, Date) for automation and logging.
  • Output in text or JSON formats to integrate with dashboards, pipelines, or downstream tasks.
  • Handles HTML content by converting to plain text and supports multipart messages.

Quick Start

Read a Gmail message by ID and output its body or headers.

Frequently Asked Questions about gws-gmail-read

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

FAQPage Schema
How do I extract the body or headers from a Gmail message in an automation workflow?

To extract the body or headers from a Gmail message, you need a valid message ID and the gws CLI. The Skill reads the message and returns the content in text or JSON, handling HTML-to-text conversion and multipart messages automatically.

Can I retrieve Gmail headers like From, To, and Subject as JSON?

Yes, you can retrieve Gmail headers such as From, To, Subject, and Date as JSON. The Skill outputs extracted header data in text or JSON formats, making it suitable for integration with dashboards, pipelines, or downstream tasks.

Does this approach support reading multipart Gmail messages?

Yes, this approach supports reading multipart Gmail messages. The Skill processes multipart content and converts HTML email bodies into plain text, ensuring you get clean, readable content for logging or further automation tasks.

What do I need to authenticate and read Gmail messages automatically?

To authenticate and read Gmail messages automatically, you need the gws CLI and proper authentication via gws-shared. You also need a valid message ID to perform the read operation and extract the email body or headers.

What is the best way to convert HTML email content to plain text for pipelines?

The best way to convert HTML email content to plain text for pipelines is to use an automation workflow that reads Gmail messages by ID. This Skill handles HTML-to-text conversion natively and outputs the body in text or JSON formats.