gws-gmail-users-threads-get
Gmail: Get a specific thread and all its messages.
SKILL.md.claude/skills/gws-gmail-users-threads-get/SKILL.md
GitHubgmail 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)
| 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
# 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 listto discover thread IDs.
See Also
- gws-gmail-users-threads-list — List threads
- gws-gmail-users-messages-get — Get a single message