Mulla759/GWSforDummies / .claude/skills/gws-gmail-users-messages-get
gws-gmail-users-messages-get
VerifiedGmail: Get a specific message by ID with configurable format.
gmail users messages get
Get a specific message by ID. Supports multiple output formats to control token usage.
Usage
gws gmail users messages get --params '<JSON>'
Parameters (--params JSON)
| Parameter | Required | Default | Description |
|---|---|---|---|
userId | ✓ | — | The user's email address or "me" for the authenticated user |
id | ✓ | — | The Gmail message ID |
format | — | full | Response format: full, metadata, minimal, raw |
metadataHeaders | — | — | Array of header names to include (only used with format: "metadata") |
Format Options
| Format | Returns | Token Cost |
|---|---|---|
minimal | ID, thread ID, labels only | Very low |
metadata | Headers only (filtered by metadataHeaders) | Low |
full | Headers + parsed body parts (base64 encoded) | High |
raw | Entire RFC 2822 message as base64 | Very high |
Examples
# Get full message
gws gmail users messages get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "full"}'
# Get only specific headers (best for security analysis)
gws gmail users messages get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "metadata", "metadataHeaders": ["From", "To", "Subject", "Date", "Authentication-Results", "Received-SPF", "DKIM-Signature", "Reply-To", "Return-Path"]}'
# Get minimal info (just labels and thread ID)
gws gmail users messages get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "minimal"}'
Tips
-
Use
format: "metadata"withmetadataHeadersto fetch only the headers you need — dramatically reduces token usage. -
To read a body, don't decode
fullyourself — use thegws gmail +readhelper. It base64-decodes, handles multipart/alternative, and converts HTML to plain text automatically:gws gmail +read --id <ID> # plain-text body gws gmail +read --id <ID> --headers # body prefixed with From/To/Subject/Date gws gmail +read --id <ID> --html | grep -oE 'href="[^"]+"' # links gws gmail +read --id <ID> --format json | jq '.body' # structuredOnly reach for
format: "full"here (raw base64url body parts) when you need part-level MIME structure that+readdoesn't expose. -
Pair with
gws gmail users messages listto discover message IDs first.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |