googleworkspace · HeroSizy · Mar 5, 2026 · Mar 5, 2026 · Mar 5, 2026 · Mar 5, 2026
diff --git a/.changeset/gmail-reply-forward.md b/.changeset/gmail-reply-forward.md
@@ -0,0 +1,10 @@
+---
+"@googleworkspace/cli": minor
+---
+
+feat(gmail): add +reply, +reply-all, and +forward helpers
+
+Adds three new Gmail helper commands:
+- `+reply` -- reply to a message with automatic threading
+- `+reply-all` -- reply to all recipients with --remove/--cc support
+- `+forward` -- forward a message to new recipients
diff --git a/docs/skills.md b/docs/skills.md
@@ -38,6 +38,9 @@ Shortcut commands for common operations.
 | [gws-sheets-read](../skills/gws-sheets-read/SKILL.md) | Google Sheets: Read values from a spreadsheet. |
 | [gws-gmail-send](../skills/gws-gmail-send/SKILL.md) | Gmail: Send an email. |
 | [gws-gmail-triage](../skills/gws-gmail-triage/SKILL.md) | Gmail: Show unread inbox summary (sender, subject, date). |
+| [gws-gmail-reply](../skills/gws-gmail-reply/SKILL.md) | Gmail: Reply to a message (handles threading automatically). |
+| [gws-gmail-reply-all](../skills/gws-gmail-reply-all/SKILL.md) | Gmail: Reply-all to a message (handles threading automatically). |
+| [gws-gmail-forward](../skills/gws-gmail-forward/SKILL.md) | Gmail: Forward a message to new recipients. |
 | [gws-gmail-watch](../skills/gws-gmail-watch/SKILL.md) | Gmail: Watch for new emails and stream them as NDJSON. |
 | [gws-calendar-insert](../skills/gws-calendar-insert/SKILL.md) | Google Calendar: Create a new event. |
 | [gws-calendar-agenda](../skills/gws-calendar-agenda/SKILL.md) | Google Calendar: Show upcoming events across all calendars. |

diff --git a/skills/gws-gmail-forward/SKILL.md b/skills/gws-gmail-forward/SKILL.md
@@ -0,0 +1,52 @@
+---
+name: gws-gmail-forward
+version: 1.0.0
+description: "Gmail: Forward a message to new recipients."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +forward --help"
+---
+
+# gmail +forward
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Forward a message to new recipients
+
+## Usage
+
+```bash
+gws gmail +forward --message-id <ID> --to <EMAILS>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--message-id` | ✓ | — | Gmail message ID to forward |
+| `--to` | ✓ | — | Recipient email address(es), comma-separated |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--cc` | — | — | CC recipients (comma-separated) |
+| `--body` | — | — | Optional note to include above the forwarded message |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below'
+gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com
+```
+
+## Tips
+
+- Includes the original message with sender, date, subject, and recipients.
+- Sends the forward as a new message rather than forcing it into the original thread.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
diff --git a/skills/gws-gmail-reply-all/SKILL.md b/skills/gws-gmail-reply-all/SKILL.md
@@ -0,0 +1,54 @@
+---
+name: gws-gmail-reply-all
+version: 1.0.0
+description: "Gmail: Reply-all to a message (handles threading automatically)."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +reply-all --help"
+---
+
+# gmail +reply-all
+
+> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
+
+Reply-all to a message (handles threading automatically)
+
+## Usage
+
+```bash
+gws gmail +reply-all --message-id <ID> --body <TEXT>
+```
+
+## Flags
+
+| Flag | Required | Default | Description |
+|------|----------|---------|-------------|
+| `--message-id` | ✓ | — | Gmail message ID to reply to |
+| `--body` | ✓ | — | Reply body (plain text) |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--cc` | — | — | Additional CC recipients (comma-separated) |
+| `--remove` | — | — | Exclude recipients from the outgoing reply (comma-separated emails) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Sounds good to me!'
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Updated' --remove bob@example.com
+gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Adding Eve' --cc eve@example.com
+```
+
+## Tips
+
+- Replies to the sender and all original To/CC recipients.
+- Use --remove to exclude recipients from the outgoing reply, including the sender or Reply-To target.
+- The command fails if exclusions leave no reply target.
+- Use --cc to add new recipients.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
diff --git a/skills/gws-gmail-reply/SKILL.md b/skills/gws-gmail-reply/SKILL.md
@@ -0,0 +1,51 @@
+---
+name: gws-gmail-reply
+version: 1.0.0
+description: "Gmail: Reply to a message (handles threading automatically)."
+metadata:
+  openclaw:
+    category: "productivity"
+    requires:
+      bins: ["gws"]
+    cliHelp: "gws gmail +reply --help"
+---
+
+# gmail +reply
+
+> **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
+
+```bash
+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) |
+| `--from` | — | — | Sender address (for send-as/alias; omit to use account default) |
+| `--cc` | — | — | Additional CC recipients (comma-separated) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
+
+## Examples
+
+```bash
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Thanks, got it!'
+gws gmail +reply --message-id 18f1a2b3c4d --body 'Looping in Carol' --cc carol@example.com
+```
+
+## Tips
+
+- Automatically sets In-Reply-To, References, and threadId headers.
+- Quotes the original message in the reply body.
+- For reply-all, use +reply-all instead.
+
+## See Also
+
+- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
+- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
diff --git a/skills/gws-gmail-send/SKILL.md b/skills/gws-gmail-send/SKILL.md
@@ -29,6 +29,7 @@ gws gmail +send --to <EMAIL> --subject <SUBJECT> --body <TEXT>
 | `--to` | ✓ | — | Recipient email address |
 | `--subject` | ✓ | — | Email subject |
 | `--body` | ✓ | — | Email body (plain text) |
+| `--dry-run` | — | — | Show the request that would be sent without executing it |
 
 ## Examples
 

diff --git a/skills/gws-gmail/SKILL.md b/skills/gws-gmail/SKILL.md
@@ -24,6 +24,9 @@ gws gmail <resource> <method> [flags]
 |---------|-------------|
 | [`+send`](../gws-gmail-send/SKILL.md) | Send an email |
 | [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |
+| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |
+| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |
+| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |
 | [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |
 
 ## API Resources