Agent skill

gws-gmail-read

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

View SKILL.md on GitHub Repository
Stars 2
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/mattforni/homebase/tree/main/.claude/skills/gws-gmail-read

Metadata

Additional technical details for this skill

version
0.22.3
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.

mattforni/homebase

gws-gmail-forward

Gmail: Forward a message to new recipients.

2 1
Explore
mattforni/homebase

gws-gmail-triage

Gmail: Show unread inbox summary (sender, subject, date).

2 1
Explore
mattforni/homebase

gws-calendar-insert

Google Calendar: Create a new event.

2 1
Explore
mattforni/homebase

gws-gmail-reply-all

Gmail: Reply-all to a message (handles threading automatically).

2 1
Explore
mattforni/homebase

job-apply

Analyze job roles for fit, draft application question responses, find hiring managers, and create follow-up emails for RYLLC job applications. Focuses on climate tech IC product/SRE roles.

2 1
Explore
mattforni/homebase

gws-calendar-agenda

Google Calendar: Show upcoming events across all calendars.

2 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results