菜单
Gmail: Get a specific message by ID with configurable format.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.