Menu
Gmail: Get a specific message by ID with configurable format.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Gmail: Create a custom label in the user's mailbox.
Gmail: List all labels in the user's mailbox.
Gmail: List messages in a user's mailbox with optional filtering.
Gmail: Modify the labels applied to a specific message.
Gmail: Create a server-side message filter (rule) that auto-labels matching mail.
Gmail: List the existing message filters (rules) in the user's mailbox.
| name | gws-gmail-users-messages-get |
| description | Gmail: Get a specific message by ID with configurable format. |
Get a specific message by ID. Supports multiple output formats to control token usage.
gws gmail users messages get --params '<JSON>'
--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 | 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 |
# 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"}'
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.