gws-gmail-read

Read Gmail messages by ID and return body or headers.

8|3|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-gmail-read-haberlah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-read
Source: https://github.com/haberlah/dotfiles-claude/tree/main/skills/gws-gmail-read
Command: npx skills add https://github.com/haberlah/dotfiles-claude --skill gws-gmail-read-haberlah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail messages are often needed for quick data extraction of bodies or headers, but retrieving and formatting that content from the inbox can be tedious and error-prone.

Core Features & Use Cases

  • Read a Gmail message by ID and return either the body or selected headers (From, To, Subject, Date) for downstream processing.
  • Support output formats (text or JSON) and optional HTML body conversion for rich content.
  • Easy integration into automation workflows for email auditing, record keeping, or data extraction from messages.

Quick Start

Read a Gmail message by ID and return its body or headers.

Frequently Asked Questions about gws-gmail-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract Gmail message headers and body content for automation workflows?

To extract Gmail message headers and body content for automation, you can read a Gmail message by ID and return specific headers like From, To, Subject, and Date, or retrieve the HTML and plain text body for downstream processing.

How do I get Gmail email body text in JSON format for data extraction?

You can get Gmail email body text in JSON format by using the --format flag. This allows you to output the extracted message body or headers as structured JSON data for easy integration into automation workflows.

Can I retrieve HTML email content from a Gmail message by ID?

Yes, you can retrieve HTML email content from a Gmail message by using the --id and --html flags. This returns the HTML body of the message, supporting rich content extraction for record keeping or auditing.

What is the best way to automate Gmail message extraction without manual inbox review?

The best way to automate Gmail message extraction without manual inbox review is using a CLI tool to fetch message bodies or headers by ID. This avoids tedious manual retrieval and supports output flags for formats like text or JSON.

Does this Gmail reading method require authentication setup?

Yes, this Gmail reading method requires authentication setup. It relies on gws-shared authentication and security rules to ensure secure access when reading messages and extracting headers or bodies.

What are the limitations of extracting Gmail headers with this method?

A limitation of extracting Gmail headers with this method is that scope is limited to specific fields like From, To, Subject, and Date. You must know the message ID beforehand, as it does not support searching or listing inbox messages.