
gws-gmail-read
Extract message body and headers from Gmail using message IDs
by googleworkspaceFree
Description
gws-gmail-read is an agent skill from the Google Workspace CLI project, listed on skills.sh. It reads a single Gmail message by its ID and returns the body, either as plain text or as HTML. It can also include the headers, such as From, To, Subject and Date. The output can be text or JSON, and the listing says the skill converts message content between formats as needed. The message is identified with the --id flag. The skill is read-only, so it does not change the mailbox. It relies on the shared gws authentication and security rules, which the agent reads first, and it can generate them if they are missing. It suits people who want an agent to pull the text of a specific email, such as a receipt or a set of instructions, into a summary or into another tool, under the account they have authorised.…
Highlights
- Reads a message by ID
- Body as plain text or HTML
- Optional headers: From, To, Subject, Date
- Text or JSON output
Ratings & Reviews
No ratings yet
Be the first to rate gws-gmail-read.
People also visit

gws-gmail-forward
Forward Gmail messages to new recipients with optional notes and attachments

himalaya
Himalaya CLI for IMAP/SMTP mail: list, read, search, compose, reply, forward

gws-calendar
Google Calendar API access for managing calendars, events, and sharing rules
gws-gmail-read FAQ
What does gws-gmail-read do?
It reads a Gmail message by its ID and returns its body and, if you ask, its headers.
How do I install it?
Run: npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-read
Can it change my mailbox?
The skill reads messages. It does not send, forward or change them.
What output formats are there?
Text or JSON, with the body as plain text or HTML.
Has it been checked for security?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Warn. A Warn or Fail is worth reading before you install.
What are the best gws-gmail-read alternatives?
Popular alternatives to gws-gmail-read include gws-gmail-forward, gws-gmail-send and gog. See all gws-gmail-read alternatives