gws-gmail-read

Installation
Summary

Extract message body and headers from Gmail using message IDs.

  • Reads individual Gmail messages by ID and returns body content in plain text or HTML format
  • Optionally includes message headers (From, To, Subject, Date) in output
  • Supports multiple output formats (text, json) and automatically converts HTML-only messages to plain text
  • Handles multipart messages and base64 decoding; includes dry-run mode for testing requests
SKILL.md

gmail +read

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Read a message and extract its body or headers

Usage

gws gmail +read --id <ID>

Flags

Related skills
Installs
14.1K
GitHub Stars
26.4K
First Seen
Mar 17, 2026