skills.rest
ma08
ma08COMMUNITY
Explore all skills by this author →
Website𝕏@curious_queueGitHub

gws-gmail-read

Retrieve Gmail message content and metadata by message ID.

28|Updated Jan 3, 2026
Search Tags:#email#gmail#gws#message retrieval#email reading#header extraction#body extraction
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-gmail-read-ma08
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-read
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-gmail-read
Command: npx skills add https://github.com/ma08/botfiles --skill gws-gmail-read-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious manual work of opening Gmail to locate and extract specific message content, saving you time when you need quick access to email details without navigating the web interface.

Core Features & Use Cases

  • Message Body Extraction: Retrieve plain text or HTML content from any Gmail message by ID, with automatic conversion of HTML-only emails to readable plain text.
  • Header Retrieval: Pull key metadata including sender, recipient, subject, and date for logging or auditing purposes.
  • Flexible Output Formats: Export extracted content as plain text or structured JSON for integration with other tools.
  • Use Case: Imagine you need to reference the body of a specific client support ticket email to include in a follow-up response. Use this Skill to instantly pull the full message content without opening your Gmail inbox.

Quick Start

Ask your AI agent to read the Gmail message with ID 18f1a2b3c4d and return its full body content along with the sender and subject 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 body content using a message ID?▼

To extract a Gmail message body, retrieve the full content using the unique message ID. This automatically handles multipart email decoding and converts HTML-only emails into readable plain text or structured JSON.

Can I retrieve Gmail email headers like sender and subject without opening the inbox?▼

Yes, you can retrieve Gmail email headers by targeting the message ID. This pulls key metadata including sender, recipient, subject, and date for logging or auditing purposes without manual inbox navigation.

Does Gmail message retrieval require the gws CLI tool?▼

Gmail message retrieval requires the gws CLI tool with valid Gmail authentication. This handles base64 content extraction, multipart decoding, and format conversion between plain text, HTML, and JSON outputs.

What is the best way to automate client support email reading for cross-tool integration?▼

Automating client support email reading is best done by retrieving structured message data via message ID. Exporting extracted body text and headers as JSON enables seamless cross-tool integration and audit logging.

What output formats are supported when extracting Gmail message content?▼

When extracting Gmail message content, supported output formats include plain text, HTML, and structured JSON. This flexible export allows integration with other tools or direct inclusion in follow-up responses.

Related Skills

Explore More Content & Communication Skills→
ma08ma08
28

gws-gmail

Automate Gmail mailbox operations for sending, reading, and organizing messages.

Community
Intermediate
haberlahhaberlah
8

gws-gmail-read

Read Gmail messages by ID and return body or headers.

Community
Intermediate
thirteen37thirteen37
1

draft-reply

Retrieve email threads and generate draft responses via Gmail API.

Community
Intermediate
cellarwoodcellarwood

gws-gmail-read

Read Gmail messages by ID and return body or headers in text or JSON.

Official
Intermediate