Skip to main content
Gmail commands. Every command follows the CLI contract: JSON on stdout, errors on stderr, and command-specific mutation safety controls. Keys resolve as described in Secrets and API keys.

gtm gmail url

Gmail URL decoding.

gtm gmail url decode

Decode a Gmail URL or token to a hex API ID, optionally fetching the message.
uv run gtm gmail url decode [OPTIONS] URL_OR_TOKEN
ArgumentTypeRequired
URL_OR_TOKENtextyes
OptionTypeDefaultDescription
--read, -rbooleanfalseFetch the message via gws after decoding
--format, -fchoiceReadFormat.textOutput format when —read is set
--htmlbooleanfalseReturn HTML body instead of plain text (text format only)
--headers, -HbooleanfalseInclude parsed headers (text format only; json/markdown always carry them)
Last modified on July 14, 2026