email-processor
Automate Gmail inbox processing - categorizes unread emails, marks marketing/newsletters/promotions as read, and surfaces important emails requiring attention. USE WHEN: User asks to "check my emails", "process unread emails", "clean up my inbox", "mark newsletters as read", or any Gmail automation task. REQUIRES: gog CLI (brew install steipete/tap/gogcli) + Google Cloud OAuth credentials
Why use this skill?
Use the OpenClaw email-processor skill to automate your Gmail triage. Automatically categorize unread mail, filter out newsletters, and surface critical alerts.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/zaynjarvis/email-processorWhat This Skill Does
The email-processor skill for OpenClaw is a powerful automation utility designed to reclaim your time by triaging your Gmail inbox. Rather than manually filtering through hundreds of messages, this agent identifies the noise and keeps your focus on what matters. It automatically categorizes unread emails, distinguishing between critical communications—such as GitHub notifications, security alerts, and direct messages—and low-priority items like newsletters, promotions, and cold outreach. By utilizing the gog CLI, the skill programmatically interacts with your Gmail account to mark clutter as read and generate a summary report of your inbox status. This ensures your inbox stays lean and actionable without you ever having to sort through marketing blasts manually.
Installation
Installation is streamlined via the OpenClaw environment. First, ensure you have the required CLI tool by running brew install steipete/tap/gogcli. Once the CLI is present, install the skill using clawhub install openclaw/skills/skills/zaynjarvis/email-processor. After installation, you must configure your Google Cloud OAuth credentials. Navigate to the Google Cloud Console, enable the Gmail API, and download your OAuth client_secret.json. Finalize the setup by executing gog auth credentials /path/to/client_secret.json and adding your account with gog auth add [email protected] --services gmail.
Use Cases
This skill is perfect for busy professionals or developers who receive heavy email traffic daily. It is ideal for cleaning up an inbox after a vacation, managing daily newsletter clutter, or ensuring that critical system notifications from platforms like GitHub are never missed amidst marketing spam. It acts as an intelligent layer that filters the deluge of information, leaving you with a curated list of tasks and important alerts.
Example Prompts
- "Hey OpenClaw, please process my unread emails and mark all the newsletters as read so I can see what is actually important."
- "Check my inbox and give me a summary of any security alerts or direct messages that require my attention."
- "Clean up my Gmail account; I have too many promotions and cold pitches cluttering my workspace."
Tips & Limitations
To get the most out of this tool, run the dry-run command provided in the documentation to ensure your filtering logic matches your expectations before automating deletions or read-marking. Note that this skill requires persistent OAuth credentials; if you change your Google password or revoke access in your Google Account settings, you will need to re-authenticate via the gog CLI. While highly effective, it is best used in environments where you have explicitly allowed third-party access to your Gmail data.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-zaynjarvis-email-processor": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, external-api, code-execution
Related Skills
openviking-mcp
Set up and run the OpenViking MCP server for RAG capabilities. Use when users need semantic search and document Q&A exposed through Model Context Protocol for Claude Desktop/CLI or other MCP clients. Triggers on requests about OpenViking MCP, RAG servers, or semantic search MCP setup.
openviking
RAG and semantic search via OpenViking Context Database MCP server. Query documents, search knowledge base, add files/URLs to vector memory. Use for document Q&A, knowledge management, AI agent memory, file search, semantic retrieval. Triggers on "openviking", "search documents", "semantic search", "knowledge base", "vector database", "RAG", "query pdf", "document query", "add resource".