Gws Gmail Reply
- 28.3k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
Google Workspace CLI is a CLI tool for programmatically accessing and automating Google Workspace services including Gmail, Drive, Calendar, and Sheets with structured JSON output.
About
The Google Workspace CLI (gws) is a universal command-line tool for interacting with Google Workspace services including Drive, Gmail, Calendar, and every Google Workspace API. It's built for both human developers and AI agents, providing structured JSON responses and 40+ pre-built agent skills. Engineers use it to automate Workspace interactions, script API calls, and integrate Workspace services into workflows.
- Dynamic CLI that reads Google APIs at runtime via Discovery Service
- 40+ included agent skills for Gmail, Drive, Calendar, and Sheets
- Structured JSON output with auto-pagination support
Gws Gmail Reply by the numbers
- 28,336 all-time installs (skills.sh)
- +920 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #24 of 2,742 Automation & Workflows skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-gmail-reply capabilities & compatibility
- Capabilities
- email automation · file management · calendar access · spreadsheet access · api integration
- Works with
- gmail · google drive
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-replyAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 28.3k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you reply to Gmail threads from a CLI agent?
Automate Google Workspace interactions and integrate Workspace APIs into applications
Who is it for?
Developers automating Gmail thread replies through the gws CLI inside Claude Code, Cursor, or Codex agent workflows.
Skip if: Developers who need to compose brand-new Gmail messages, bulk-send campaigns, or manage Gmail without installing and authenticating the gws CLI.
When should I use this skill?
A user asks an agent to reply to a specific Gmail message ID or continue an existing Gmail thread from the terminal.
What you get
Threaded Gmail reply sent via gws CLI with correct In-Reply-To and References headers
- threaded Gmail reply sent via gws CLI
By the numbers
- 40+ included agent skills covering Gmail, Drive, Docs, Calendar, and Sheets
- 100+ total agent skills in full repository across all Workspace services
- Dynamically reads from Google Discovery Service at runtime
Files
gmail +reply
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Reply to a message (handles threading automatically)
Usage
gws gmail +reply --message-id <ID> --body <TEXT>Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--message-id | ✓ | — | Gmail message ID to reply to |
--body | ✓ | — | Reply body (plain text, or HTML with --html) |
--from | — | — | Sender address (for send-as/alias; omit to use account default) |
--to | — | — | Additional To email address(es), comma-separated |
--attach | — | — | Attach a file (can be specified multiple times) |
--cc | — | — | CC email address(es), comma-separated |
--bcc | — | — | BCC email address(es), comma-separated |
--html | — | — | Treat --body as HTML content (default is plain text) |
--dry-run | — | — | Show the request that would be sent without executing it |
--draft | — | — | Save 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' --draftTips
- 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 (<p>, <b>, <a>, etc.) — no <html>/<body> 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
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Related skills
Agent BrowserGive their coding agent reliable, high-fidelity control over any website or Electron desktop app.577k39.1k
Lark ApprovalLet their AI coding agent create, read, update, and approve items in Lark (Feishu) approval workflows without leaving the coding environment.471kLark EventHandle Feishu/Lark bot events, webhooks, and subscription callbacks in agent-driven backend code.471kLark Workflow Meeting SummaryAutomatically generate structured meeting summaries and action items from Lark/Feishu calls without manual note-taking.470kLark Workflow Standup ReportAutomatically generate and post daily standup reports in Lark/Feishu from their workflow and activity data.470kLark Vc AgentGive their coding agent the ability to read, create, and update documents, tasks, and wiki pages inside Feishu (Lark).415kHow it compares
Choose gws-gmail-reply over generic Gmail API snippets when you already use the gws CLI and only need threaded replies, not full mailbox CRUD.
FAQ
What command sends a Gmail reply with gws-gmail-reply?
gws-gmail-reply uses `gws gmail +reply --message-id <ID> --body <TEXT>`. The `--message-id` flag is required and identifies the Gmail message to reply to; threading headers are applied automatically.
What must be installed before using gws-gmail-reply?
gws-gmail-reply requires the `gws` CLI binary (v0.22.5 in the repo) and the `gws-shared` skill for OAuth auth, global flags, and security rules. Run `gws generate-skills` if shared prerequisites are missing.
Is Gws Gmail Reply safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.