Recipe Create Gmail Filter

A straightforward recipe for setting up Gmail filters through the command line using Google Workspace tools. You'll create labels, define filter criteria based on sender or subject patterns, and specify actions like auto-labeling or starring messages. The four-step process covers listing existing labels, creating new ones, building the actual filter with JSON criteria, and verifying it worked. Most useful when you need to automate email organization at scale or integrate Gmail filtering into larger workflow scripts. The commands are clean and the JSON structure is simple enough to modify for different filter rules.

skills.sh installs: 32K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill recipe-create-gmail-filter --agent claude-code

Installs into .claude/skills of the current project.

Files

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

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

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly