Create a Gmail Filter

SkillCommunication

Lets your agent create Gmail filters that automatically label, star, or categorize incoming email.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Create a Gmail Filter skill

About this capability

Create a Gmail filter to automatically label, star, or categorize incoming messages.

What this skill tells your AI

The instructions your AI receives, as published by googleworkspace/cli in skills/recipe-create-gmail-filter/SKILL.md and read by ahel’s review.

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

Create a Gmail filter to automatically label, star, or categorize incoming messages.

Steps

  1. List existing labels: gws gmail users labels list --params '{"userId": "me"}' --format table
  2. Create a new label: gws gmail users labels create --params '{"userId": "me"}' --json '{"name": "Receipts"}'
  3. Create a filter: gws gmail users settings filters create --params '{"userId": "me"}' --json '{"criteria": {"from": "receipts@example.com"}, "action": {"addLabelIds": ["LABEL_ID"], "removeLabelIds": ["INBOX"]}}'
  4. Verify filter: gws gmail users settings filters list --params '{"userId": "me"}' --format table

Signals

GitHub stars
31k
Forks
2k
Last commit
Sep 2026

ahel review

  • S4info
    community integration — published by googleworkspace, not gmail

Automated review, not a security audit. Ruleset v1.

Advanced
Catalog kind
skill
Gateway key
recipe-create-gmail-filter
Source
github.com/googleworkspace/cli