gws-gmail-read

This skill documents the `gws gmail +read` command from the Google Workspace CLI, which reads a single Gmail message by ID and extracts its body or headers. It solves the narrow task of programmatically retrieving message content from Gmail in a scriptable way, part of a larger family of gws skills for working with email.

The command takes a required message ID and offers optional flags to include headers (From, To, Subject, Date), choose the output format (text or JSON), return the HTML body instead of plain text, and perform a dry run that shows the request that would be sent without executing it. It automatically converts HTML-only messages to plain text and handles multipart/alternative content and base64 decoding, so callers get usable text without manual parsing. JSON output composes cleanly with tools like jq for extracting specific fields such as the body. The skill points to a shared gws-shared skill for authentication, global flags, and security rules, indicating credentials and auth are handled by the official CLI's own tooling rather than this skill.

It targets developers, automation authors, and productivity users who want to pull Gmail message content into scripts or agent workflows. The operation is strictly read-only retrieval of a message the authenticated user can already access; it does not send, delete, or modify mail, and it exposes a dry-run option for safe inspection of requests.