Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
googleworkspace avatar

Recipe Forward Labeled Emails

  • 24.5k installs
  • 30.2k repo stars
  • Updated August 1, 2026
  • googleworkspace/cli

recipe-forward-labeled-emails is a CLI recipe that finds Gmail messages with labels and forwards them automatically.

About

A recipe for automatically finding and forwarding Gmail messages with specific labels. Use this when you need to route labeled emails from team members or specific senders to another address for review or processing.

  • Find emails with specific labels and forward them automatically
  • Route labeled messages to designated recipients
  • Preserve original message content in forwarded emails

Recipe Forward Labeled Emails by the numbers

  • 24,502 all-time installs (skills.sh)
  • +347 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #37 of 2,715 Automation & Workflows skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

recipe-forward-labeled-emails capabilities & compatibility

Works with
gmail
Use cases
email · orchestration
From the docs

What recipe-forward-labeled-emails says it does

Find Gmail messages with a specific label and forward them to another address.
SKILL.md
npx skills add https://github.com/googleworkspace/cli --skill recipe-forward-labeled-emails

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs24.5k
repo stars30.2k
Security audit3 / 3 scanners passed
Last updatedAugust 1, 2026
Repositorygoogleworkspace/cli

How do you forward labeled Gmail messages from CLI?

Automatically find and forward Gmail messages with specific labels to designated recipients.

Who is it for?

Routing labeled emails to specific recipients for review

Skip if: Teams relying on Gmail filters in the web UI or third-party ticketing systems that do not expose label-query automation through gws.

When should I use this skill?

Automating email forwarding based on labels

What you get

Forwarded Gmail messages from a labeled query to a target recipient address.

  • forwarded labeled gmail messages

By the numbers

  • Metadata version 0.22.5
  • Documents 2 gws gmail steps: messages list and messages get

Files

SKILL.mdMarkdownGitHub ↗

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 manager@company.com --subject 'FW: [Original Subject]' --body 'Forwarding for your review:

[Original Message Body]'`

Related skills

FAQ

How does recipe-forward-labeled-emails find messages?

recipe-forward-labeled-emails uses gws gmail users messages list with a query parameter such as label:needs-review, then fetches each message with gws gmail users messages get before forwarding.

What does recipe-forward-labeled-emails require?

recipe-forward-labeled-emails requires the gws binary and the gws-gmail utility skill. All Gmail list, get, and forward steps run through authenticated gws gmail commands.

Is Recipe Forward Labeled Emails safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.