gws-gmail-forward
installsforks
How to install gws-gmail-forward?
googleworkspace/cli/gws-gmail-forward
$npx -y skills add googleworkspace/cli --skill gws-gmail-forwardGmail: Forward a message to new recipients.
SKILL.md
| 1 | # gmail +forward |
| 2 | |
| 3 | > **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it. |
| 4 | |
| 5 | Forward a message to new recipients |
| 6 | |
| 7 | ## Usage |
| 8 | |
| 9 | ```bash |
| 10 | gws gmail +forward --message-id <ID> --to <EMAILS> |
| 11 | ``` |
| 12 | |
| 13 | ## Flags |
| 14 | |
| 15 | | Flag | Required | Default | Description | |
| 16 | |------|----------|---------|-------------| |
| 17 | | `--message-id` | ✓ | — | Gmail message ID to forward | |
| 18 | | `--to` | ✓ | — | Recipient email address(es), comma-separated | |
| 19 | | `--from` | — | — | Sender address (for send-as/alias; omit to use account default) | |
| 20 | | `--body` | — | — | Optional note to include above the forwarded message (plain text, or HTML with --html) | |
| 21 | | `--no-original-attachments` | — | — | Do not include file attachments from the original message (inline images in --html mode are preserved) | |
| 22 | | `--attach` | — | — | Attach a file (can be specified multiple times) | |
| 23 | | `--cc` | — | — | CC email address(es), comma-separated | |
| 24 | | `--bcc` | — | — | BCC email address(es), comma-separated | |
| 25 | | `--html` | — | — | Treat --body as HTML content (default is plain text) | |
| 26 | | `--dry-run` | — | — | Show the request that would be sent without executing it | |
| 27 | | `--draft` | — | — | Save as draft instead of sending | |
| 28 | |
| 29 | ## Examples |
| 30 | |
| 31 | ```bash |
| 32 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com |
| 33 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below' |
| 34 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com |
| 35 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html |
| 36 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf |
| 37 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments |
| 38 | gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --draft |
| 39 | ``` |
| 40 | |
| 41 | ## Tips |
| 42 | |
| 43 | - Includes the original message with sender, date, subject, and recipients. |
| 44 | - Original attachments are included by default (matching Gmail web behavior). |
| 45 | - With --html, inline images are also preserved via cid: references. |
| 46 | - In plain-text mode, inline images are not included (matching Gmail web). |
| 47 | - Use --no-original-attachments to forward without the original message's files. |
| 48 | - Use -a/--attach to add extra file attachments. Can be specified multiple times. |
| 49 | - Combined size of original and user attachments is limited to 25MB. |
| 50 | - With --html, the forwarded block uses Gmail's gmail_quote CSS classes and preserves HTML formatting. Use fragment tags (<p>, <b>, <a>, etc.) — no <html>/<body> wrapper needed. |
| 51 | - Use --draft to save the forward as a draft instead of sending it immediately. |
| 52 | |
| 53 | ## See Also |
| 54 | |
| 55 | - [gws-shared](../gws-shared/SKILL.md) — Global flags and auth |
| 56 | - [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands |
People who liked this also viewed
6 picksType
- azure-resource-lookupList, find, and show Azure resources across subscriptions or resource groups. Handles prompts like \"list the websites in my subscription\", \"list my web apps\", \"show my app services\", \"list virtSkillsJul 2026
- azure-messagingTroubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. SkillsJul 2026
- lark-doc飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 SkillsJul 2026
- lark-im飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 FeedSkillsJul 2026
- lark-wiki飞书知识库：管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URLSkillsJul 2026
- lark-mail飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only. Do not use for docs/sheets/calendar/auth setup/pure contact lookup/IM chSkillsJul 2026
