Gmail Label Manager

What This Skill Does

The Gmail Label Manager by coenenp is a sophisticated automation skill designed to declutter your inbox by leveraging the intelligence of your existing historical data. Instead of relying on rigid, manual filters that break when patterns change, this agent analyzes your already archived emails to learn how you organize your digital life. When a new email arrives in your inbox, the agent identifies the sender and examines the labels previously applied to emails from that same source. It then intelligently mirrors that tagging structure, while simultaneously purging noise labels like 'CATEGORY_PROMOTIONS' or 'UNREAD'. Finally, it archives the message to keep your Inbox clean, ensuring that your most important correspondence is categorized exactly as you prefer without any manual intervention.

Installation

To integrate this skill into your OpenClaw environment, follow these steps:

1. Ensure you have the gog CLI installed and authenticated to grant the necessary Gmail API permissions.
2. Navigate to your terminal and execute: clawhub install openclaw/skills/skills/coenenp/gmail-label-manager.
3. Once installed, verify the file structure in your workspace. If you have custom Gmail label hierarchies, check the script's configuration to ensure it matches your local environment paths.
4. Run the included script.sh manually once to verify that the agent can successfully fetch your email history and process a test message.

Use Cases

This skill is ideal for power users and professionals who struggle with inbox fatigue. Common use cases include: sorting newsletters into specific project folders, separating receipts from general correspondence, and automating the triage of recurring notifications (like system alerts or service updates) that usually clutter the primary view. It is particularly effective for users who want a 'Zero Inbox' workflow but lack the time to maintain complex Gmail filters.

Example Prompts

• "OpenClaw, run the Gmail Label Manager to process my current inbox and archive everything that has been identified and labeled."
• "Update my labels by analyzing my latest archived emails from this week to ensure the manager is learning my newest folder structure."
• "Check for any unread emails from my bank and apply the appropriate finance labels, then archive the thread automatically."

Tips & Limitations

To get the best results, ensure your 'Archived' folder is well-organized, as the agent relies on this as its primary training data. If your historical labels are inconsistent, the agent might struggle to identify a pattern. Always test with a small subset of emails before running it on your entire archive. Note that this skill requires consistent network access to interact with the Gmail API and should be monitored to ensure it does not remove labels you prefer to keep.