Agent skill

gws-gmail-read

Gmail: Read a message and extract its body or headers.

View SKILL.md on GitHub Repository
Stars 24,434
Forks 1,240

Install this agent skill to your Project

npx add-skill https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-read

Metadata

Additional technical details for this skill

version
0.22.5
openclaw 
{
    "cliHelp": "gws gmail +read --help",
    "category": "productivity",
    "requires": {
        "bins": [
            "gws"
        ]
    }
}

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

bash
gws gmail +read --id <ID>

Flags

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

Examples

bash
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

googleworkspace/cli

gws-events-renew

Google Workspace Events: Renew/reactivate Workspace Events subscriptions.

24,434 1,240
Explore
googleworkspace/cli

gws-forms

Read and write Google Forms.

24,434 1,240
Explore
googleworkspace/cli

gws-chat

Google Chat: Manage Chat spaces and messages.

24,434 1,240
Explore
googleworkspace/cli

gws-modelarmor-sanitize-prompt

Google Model Armor: Sanitize a user prompt through a Model Armor template.

24,434 1,240
Explore
googleworkspace/cli

gws-workflow-standup-report

Google Workflow: Today's meetings + open tasks as a standup summary.

24,434 1,240
Explore
googleworkspace/cli

persona-team-lead

Lead a team — run standups, coordinate tasks, and communicate.

24,434 1,240
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results