Agent skill · writing content · googleworkspace

recipe-create-gmail-filter

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

Why this skill is useful

Adds 4 executable scripts for creating and managing Gmail filters that aren't in public docs.

What it needs

Requires gws installed locally. Requires gmail account access. About 1k tokens when loaded. Last updated 2026-08-01. 30,245 stars on the source repository.

What this skill does

Create a Gmail Filter 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": ["LABELID"], "removeLabelIds": ["INBOX"]}}' 4. Verify filter: gws gmail users settings filters list --params '{"userId": "me"}' --format table

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills googleworkspace/recipe-create-gmail-filter

View the source on GitHub

Browse the @skills marketplace