Skip to content

Mulla759/GWSforDummies / .claude/skills/gws-gmail-users-messages-get

gws-gmail-users-messages-get

Verified

Gmail: 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)

ParameterRequiredDefaultDescription
userId✓—The user's email address or "me" for the authenticated user
id✓—The Gmail message ID
format—fullResponse format: full, metadata, minimal, raw
metadataHeaders——Array of header names to include (only used with format: "metadata")

Format Options

FormatReturnsToken Cost
minimalID, thread ID, labels onlyVery low
metadataHeaders only (filtered by metadataHeaders)Low
fullHeaders + parsed body parts (base64 encoded)High
rawEntire RFC 2822 message as base64Very 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" with metadataHeaders to fetch only the headers you need — dramatically reduces token usage.

  • To read a body, don't decode full yourself — use the gws gmail +read helper. 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'         # structured
    

    Only reach for format: "full" here (raw base64url body parts) when you need part-level MIME structure that +read doesn't expose.

  • Pair with gws gmail users messages list to discover message IDs first.

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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall