Skip to content

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

gws-gmail-users-threads-get

Verified

Gmail: Get a specific thread and all its messages.

gmail users threads get

Get a specific thread by ID. Returns all messages in the thread, useful for understanding conversation context.

Usage

gws gmail users threads get --params '<JSON>'

Parameters (--params JSON)

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

Format Options

FormatReturnsToken Cost
minimalIDs and labels for each message in the threadVery low
metadataHeaders only for each message (filtered)Low
fullHeaders + parsed body parts for each messageHigh

Examples

# Get full thread with all messages
gws gmail users threads get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "full"}'

# Get thread metadata only (headers for each message)
gws gmail users threads get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "metadata", "metadataHeaders": ["From", "To", "Subject", "Date"]}'

# Get minimal thread info (just message IDs and labels)
gws gmail users threads get --params '{"userId": "me", "id": "19ea3ab6ef5d5f9f", "format": "minimal"}'

Response Shape

{
  "id": "19ea3ab6ef5d5f9f",
  "historyId": "50817087",
  "messages": [
    {
      "id": "19ea3ab6ef5d5f9f",
      "threadId": "19ea3ab6ef5d5f9f",
      "labelIds": ["INBOX", "UNREAD"],
      "payload": { ... }
    },
    {
      "id": "19ea3cd8a1b2e3f4",
      "threadId": "19ea3ab6ef5d5f9f",
      "payload": { ... }
    }
  ]
}

Tips

  • Thread ID often matches the first message ID in the thread.
  • Use format: "metadata" to get conversation flow (who replied when) without loading full bodies.
  • Pair with gws gmail users threads list to discover thread IDs.

See Also

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