AutoGineer
Generated banner for Gws Gmail Read
Generated logo for Gws Gmail Read

Gws Gmail Read

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Gmail: Read a message and extract its body or headers.
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-gmail-read skill provides a command-line interface for interacting with Gmail messages. It allows users to fetch specific emails by their ID and extract either the message body or metadata headers. The tool handles common email complexities such as base64 decoding and multipart/alternative content, and it can automatically convert HTML content into plain text for easier processing.

What it does

  • Fetches the content of a specific Gmail message using its unique ID.
  • Extracts message headers including From, To, Subject, and Date.
  • Converts HTML email bodies into plain text format.
  • Supports output in both text and JSON formats for programmatic use.
  • Handles base64 decoding and multipart email structures automatically.

When to use it

  • When you need to programmatically retrieve email content for data processing.
  • When you need to extract specific metadata from an email header.
  • When you want to integrate Gmail message reading into a shell script or automation pipeline.
  • When you need to convert HTML-formatted emails into plain text for analysis.

Advantages

  • Simplifies email retrieval by handling complex encoding and formatting automatically.
  • Provides flexible output options including JSON for integration with other tools like jq.
  • Allows for dry-run testing to verify requests before execution.
  • Streamlines workflow by enabling email access directly from the terminal.

Usage examples

“Read the body of the email with ID 18f1a2b3c4d.”
The agent executes the command to fetch and display the plain text body of the specified email.
“Get the headers and body of email 18f1a2b3c4d in JSON format.”
The agent returns a structured JSON object containing the email headers and content, suitable for parsing.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/googleworkspace/gws-gmail-read/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-gmail-read.zip -d .agents/skills

Documentation by Google Workspace

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

FlagRequiredDefaultDescription
--id✓—The Gmail message ID to read
--headers——Include headers (From, To, Subject, Date) in the output
--format—textOutput format (text, json)
--html——Return HTML body instead of plain text
--dry-run——Show the request that would be sent without executing it

Examples

gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'

Tips

  • Converts HTML-only messages to plain text automatically.

  • Handles multipart/alternative and base64 decoding.

See Also

  • gws-shared — Global flags and auth

  • gws-gmail — All send, read, and manage email commands

Files

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

FlagRequiredDefaultDescription
--id✓—The Gmail message ID to read
--headers——Include headers (From, To, Subject, Date) in the output
--format—textOutput format (text, json)
--html——Return HTML body instead of plain text
--dry-run——Show the request that would be sent without executing it

Examples

gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'

Tips

  • Converts HTML-only messages to plain text automatically.

  • Handles multipart/alternative and base64 decoding.

See Also

  • gws-shared — Global flags and auth

  • gws-gmail — All send, read, and manage email commands

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-gmail-read · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-gmail-read.zip