Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot official · Google

recipe-forward-labeled-emails — Claude Code skill: install

Finds Gmail messages with a chosen label and forwards them to another address. Useful when labeled mail needs review elsewhere.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -a claude-code
Open on GitHub

What recipe-forward-labeled-emails does

recipe-forward-labeled-emails searches Gmail by label, reads a matching message, then sends a new email with its subject and body. The recipe uses label:needs-review as its example query, and the agent can apply the label you provide.

The skill requires the gws binary and the gws-gmail skill. Its workflow uses gws gmail users messages list, gws gmail users messages get, and gws gmail +send. The recipient, subject, and message body are set when the new email is sent.

Install it when labeled Gmail messages should be routed to a reviewer. Choose another workflow if you need to preserve the original message as-is instead of sending a new email.

What it helps with

  • find Gmail messages with a chosen label
  • read the content of a matching message
  • forward mail to a reviewer’s address
  • build a subject with the FW: prefix

Example prompts for the agent

  • Find Gmail messages labeled `needs-review` and forward them to `[email protected]`.
  • Use `gws gmail users messages get` to read the message, then send a new email with subject `FW: [Original Subject]`.
  • Search labeled messages with `gws gmail users messages list`.

How to install recipe-forward-labeled-emails

1Skills CLI (Vercel)

npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -a claude-code

2Manually: put the files in place

~/.claude/skills/recipe-forward-labeled-emails/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/recipe-forward-labeled-emails/

From the same set95

The whole set →
gws-gmail official googleworkspace This skill hands your agent Gmail: send mail, read the inbox, reply in a thread. Useful when email work already runs through the gws CLI. Claude Code CX Codex Cursor +1 81,900installs gws-gmail-send official googleworkspace A skill that teaches your agent to send Gmail from the terminal: recipients, subject, body, attachments and drafts. Claude Code CX Codex Cursor +1 74,700installs gws-drive official googleworkspace This skill hands your agent Google Drive through the gws CLI: files, folders, shared drives, comments and access requests. Useful when docs move through code. Claude Code CX Codex Cursor +1 74,500installs gws-shared official googleworkspace This skill gives agents shared rules for gws CLI authentication, flags, and output formats. Use it when working with gws commands. Claude Code CX Codex Cursor +1 66,000installs gws-calendar official googleworkspace Manage Google Calendar events, access rules, and schedules through the gws CLI tool. Claude Code CX Codex Cursor +1 61,100installs gws-sheets official googleworkspace This skill lets an agent read and edit Google Sheets through the CLI. Use it when a coding workflow needs spreadsheet data or table updates. Claude Code CX Codex Cursor +1 58,800installs gws-docs official googleworkspace This skill lets an agent read and update Google Docs through gws. Use it when document changes should happen from an agent chat. Claude Code CX Codex Cursor +1 58,300installs gws-sheets-read official googleworkspace Reads cell values and sheets from Google Spreadsheets via CLI. Useful when an agent needs spreadsheet data without risk of altering it. Claude Code CX Codex Cursor +1 50,600installs

Similar

Questions about recipe-forward-labeled-emails

How do I install recipe-forward-labeled-emails in Claude Code?

Run npx skills add googleworkspace/cli --skill recipe-forward-labeled-emails -a claude-code. The skill file is placed at ~/.claude/skills/recipe-forward-labeled-emails/SKILL.md.

What does recipe-forward-labeled-emails do?

It finds Gmail messages with a chosen label, reads their content, and sends a new email to the address you provide.

What does recipe-forward-labeled-emails require?

It requires the gws binary and the gws-gmail skill. The recipe sends a new email containing the selected message content.

Source text

SKILL.md · Apache-2.0
---
name: recipe-forward-labeled-emails
description: "Find Gmail messages with a specific label and forward them to another address."
metadata:
  version: 0.22.5
  openclaw:
    category: "recipe"
    domain: "productivity"
    requires:
      bins:
        - gws
      skills:
        - gws-gmail
---

# Forward Labeled Gmail Messages

> **PREREQUISITE:** Load the following skills to execute this recipe: `gws-gmail`

Find Gmail messages with a specific label and forward them to another address.

## Steps

1. Find labeled messages: `gws gmail users messages list --params '{"userId": "me", "q": "label:needs-review"}' --format table`
2. Get message content: `gws gmail users messages get --params '{"userId": "me", "id": "MSG_ID"}'`
3. Forward via new email: `gws gmail +send --to [email protected] --subject 'FW: [Original Subject]' --body 'Forwarding for your review:

[Original Message Body]'`

© googleworkspace · Apache-2.0 · googleworkspace/cli

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor