gws-gmail-read

Read Gmail messages by ID and extract body or headers as text or JSON.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/vikingokft/vikingo-studio-skills --skill gws-gmail-read-vikingokft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-read
Source: https://github.com/vikingokft/vikingo-studio-skills/tree/main/google/gws-gmail-read
Command: npx skills add https://github.com/vikingokft/vikingo-studio-skills --skill gws-gmail-read-vikingokft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail users need to programmatically access message content or headers for automation, auditing, and CRM workflows without manual steps.

Core Features & Use Cases

  • Read a Gmail message by ID and extract its body or headers for downstream processing.
  • Output in text or JSON, with optional HTML body rendering for rich content.
  • Use in automation pipelines to index or summarize email content for CRM, ticketing, or support workflows.

Quick Start

Read a Gmail message by ID and output 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 programmatically extract a Gmail message body by ID?

To extract a Gmail message body by ID, use a CLI automation tool that fetches the message and outputs the content in text or JSON. This Skill reads individual Gmail messages by ID and extracts the body or headers for downstream processing.

Can I retrieve Gmail email headers and output them as JSON?

Yes, you can retrieve Gmail email headers and output them as JSON. The Skill reads individual Gmail messages by ID, applies options to include specific headers, and returns the extracted data structured as JSON for automation pipelines.

How does the gws binary work with Gmail message extraction?

The gws binary executes the Gmail message extraction by reading individual messages via ID. It conforms to global authentication and safety rules defined in gws-shared, applying options to output text or JSON and optionally render HTML bodies.

What is the best way to automate reading Gmail messages for CRM workflows?

The best way to automate reading Gmail messages for CRM workflows is using a CLI tool that reads messages by ID and extracts bodies or headers. This Skill outputs text or JSON, enabling seamless indexing or summarizing for ticketing and support pipelines.

Does Gmail message extraction support returning HTML body content?

Yes, Gmail message extraction supports returning HTML body content. When reading a Gmail message by ID, you can apply an option to optionally return HTML, allowing rich content rendering alongside standard text or JSON output formats.

Are there limitations when applying Gmail message extraction to multiple emails?

Yes, a key limitation is that this Gmail message extraction applies to individual messages only. You must process emails one by one using their unique message ID rather than batch reading multiple emails simultaneously in a single operation.