Mulla759/GWSforDummies / .claude/skills/gws-gmail-users-threads-get
gws-gmail-users-threads-get
VerifiedGmail: Get a specific thread and all its messages.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.8 KB |
SKILL.md
View on GitHub---
name: gws-gmail-users-threads-get
description: "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
```bash
gws gmail users threads get --params '<JSON>'
```
## Parameters (`--params` JSON)
| Parameter | Required | Default | Description |
| ------------------ | -------- | ------- | ---------------------------------------------------------------------- |
| `userId` | ✓ | — | The user's email address or `"me"` for the authenticated user |
| `id` | ✓ | — | The thread ID |
| `format` | — | `full` | Response format: `full`, `metadata`, `minimal` |
| `metadataHeaders` | — | — | Array of header names to include (only used with `format: "metadata"`) |
## Format Options
| Format | Returns | Token Cost |
| ---------- | ------------------------------------------------------ | ---------- |
| `minimal` | IDs and labels for each message in the thread | Very low |
| `metadata` | Headers only for each message (filtered) | Low |
| `full` | Headers + parsed body parts for each message | High |
## Examples
```bash
# 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
```json
{
"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
- [gws-gmail-users-threads-list](../gws-gmail-users-threads-list/SKILL.md) — List threads
- [gws-gmail-users-messages-get](../gws-gmail-users-messages-get/SKILL.md) — Get a single message
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 |