Recipe Create Gmail Filter
- 25.3k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
recipe-create-gmail-filter is a Google Workspace CLI recipe skill that creates Gmail filters via gws gmail commands to automatically label, star, archive, or categorize incoming messages.
About
recipe-create-gmail-filter is a Google Workspace CLI recipe for automating Gmail inbox rules. The recipe lists existing labels with gws gmail users labels list, creates labels via gws gmail users labels create, and defines filters that label, star, or archive incoming messages. Developers reach for recipe-create-gmail-filter when scripting Gmail triage without clicking through the Gmail UI for every rule.
- Automates Gmail labeling and categorization for receipts, newsletters, and support emails
- Four-step recipe: list labels, create label, create filter, verify filter
- Uses structured JSON criteria for from, subject, and action rules
Recipe Create Gmail Filter by the numbers
- 25,313 all-time installs (skills.sh)
- +821 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #54 of 3,301 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
recipe-create-gmail-filter capabilities & compatibility
- Works with
- gmail
- Use cases
npx skills add https://github.com/googleworkspace/cli --skill recipe-create-gmail-filterAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 25.3k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 3 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you create Gmail filters from the command line?
Automatically label, star, or archive incoming Gmail messages using predefined rules.
Who is it for?
Developers using gws who want repeatable CLI steps to create Gmail labels and filters for inbox automation.
Skip if: Bulk email sending, Chat notifications, or users without gws-gmail and Google Workspace Gmail API access.
When should I use this skill?
User asks to create a Gmail filter, auto-label messages, star incoming mail, or automate Gmail triage with gws.
What you get
Gmail labels, filter rules, and automated label-star-archive actions on incoming messages
- Gmail labels
- Gmail filter rules
By the numbers
- Ships with googleworkspace/cli metadata version 0.22.5
- Recipe domain tagged productivity in openclaw metadata
Files
Create a Gmail Filter
PREREQUISITE: Load the following skills to execute this recipe: gws-gmailCreate 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
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.645k185kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.547k185k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.466kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).466kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.466kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.465kHow it compares
Use recipe-create-gmail-filter for one-shot inbox rule setup; use persona-project-manager when filters are part of broader project coordination.
FAQ
What gws commands does recipe-create-gmail-filter use?
recipe-create-gmail-filter starts by listing labels with gws gmail users labels list, then creates labels via gws gmail users labels create, and finally defines filters that label, star, or categorize incoming Gmail messages.
What skills are required for recipe-create-gmail-filter?
recipe-create-gmail-filter requires the gws CLI binary, the gws-gmail utility skill, and gws-shared/SKILL.md for authentication. Metadata lists googleworkspace/cli version 0.22.5.
Is Recipe Create Gmail Filter safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.