skills.rest
mattforni
mattforniCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-gmail-read

Read Gmail messages by ID and extract body or headers.

2|1|Updated Jan 31, 2014
Search Tags:#automation#cli#email#gmail#headers#read#body-extraction
One-click install
npx skills add https://github.com/mattforni/homebase --skill gws-gmail-read
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-read
Source: https://github.com/mattforni/homebase/tree/main/.claude/skills/gws-gmail-read
Command: npx skills add https://github.com/mattforni/homebase --skill gws-gmail-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail users or automation workflows often need to read a message and extract its body or key headers without manual steps.

Core Features & Use Cases

  • Read a Gmail message by ID and extract the body text or headers (From, To, Subject, Date).
  • Output in plain text or JSON, with optional HTML-to-text conversion and support for multipart messages.
  • Use in automation to feed extracted data into logs, dashboards, or other tools.

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 extract the body from a Gmail message by ID in an automation workflow?▼

You can extract a Gmail message body by specifying the message with the --id flag. The Skill handles multipart messages and automatically converts HTML-only bodies to plain text for use in automation workflows.

Can I extract email headers like From, To, and Subject from Gmail programmatically?▼

Yes, you can extract standard Gmail headers such as From, To, Subject, and Date by using the --headers flag. This allows automation workflows to retrieve message metadata without the body text.

Does this Gmail reading tool support JSON output for parsed emails?▼

Yes, the tool supports JSON output formatting via the --format flag. This enables seamless integration of extracted email bodies or headers into downstream logs, dashboards, and other automation tools.

How does the tool handle multipart Gmail messages when extracting body text?▼

The tool natively handles multipart Gmail messages by processing the various parts to extract the body text. It also automatically converts HTML-only messages to plain text for consistent output.

What is needed to read Gmail messages and extract headers via command line?▼

Reading Gmail messages and extracting headers via command line requires the gws framework and an active Gmail account context. The Skill operates within this context and requires no additional dependencies.

Can I test Gmail body extraction without actually processing the message?▼

Yes, you can simulate Gmail body extraction without processing actual messages by using the --dry-run flag. This allows you to verify command execution and workflow integration safely.

Related Skills

Explore More Software Engineering Skills→
temple-slopetemple-slope

gws-workflow-email-to-task

Convert a Gmail message into a Google Tasks entry using message ID and optional tasklist ID.

Community
Intermediate
haberlahhaberlah
8

gws-gmail-read

Read Gmail messages by ID and return body or headers.

Community
Intermediate
wuyyyyyouwuyyyyyou

gws-gmail-read

Read Gmail messages by ID and extract body or headers.

Community
Intermediate
chaddorseychaddorsey

gws-gmail-reply

Send Gmail replies with automatic thread management via the Gmail API.

Community
Intermediate