gmail +reply

SkillCommunication

Lets your agent reply to Gmail messages, keeping email threads organized automatically.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gmail +reply skill

About this capability

Gmail: Reply to a message (handles threading automatically).

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/gws-gmail-reply/SKILL.md and read by ahel’s review.

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Reply to a message (handles threading automatically)

Usage

gws gmail +reply --message-id <ID> --body <TEXT>

Flags

FlagRequiredDefaultDescription
--message-idGmail message ID to reply to
--bodyReply body (plain text, or HTML with --html)
--fromSender address (for send-as/alias; omit to use account default)
--toAdditional To email address(es), comma-separated
--attachAttach a file (can be specified multiple times)
--ccCC email address(es), comma-separated
--bccBCC email address(es), comma-separated
--htmlTreat --body as HTML content (default is plain text)
--dry-runShow the request that would be sent without executing it
--draftSave as draft instead of sending

Examples

gws gmail +reply --message-id 18f1a2b3c4d --body 'Thanks, got it!'
gws gmail +reply --message-id 18f1a2b3c4d --body 'Looping in Carol' --cc carol@example.com
gws gmail +reply --message-id 18f1a2b3c4d --body 'Adding Dave' --to dave@example.com
gws gmail +reply --message-id 18f1a2b3c4d --body '<b>Bold reply</b>' --html
gws gmail +reply --message-id 18f1a2b3c4d --body 'Updated version' -a updated.docx
gws gmail +reply --message-id 18f1a2b3c4d --body 'Draft reply' --draft

Tips

  • Automatically sets In-Reply-To, References, and threadId headers.
  • Quotes the original message in the reply body.
  • --to adds extra recipients to the To field.
  • Use -a/--attach to add file attachments. Can be specified multiple times.
  • With --html, the quoted block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (, , , etc.) — no / wrapper needed.
  • With --html, inline images in the quoted message are preserved via cid: references.
  • Use --draft to save the reply as a draft instead of sending it immediately.
  • For reply-all, use +reply-all instead.

See Also

Signals

GitHub stars
31k
Forks
2k
Last commit
Sep 2026

ahel review

  • S4info
    community integration — published by googleworkspace, not gmail

Automated review, not a security audit. Ruleset v1.

Advanced
Catalog kind
skill
Gateway key
gws-gmail-reply
Source
github.com/googleworkspace/cli