gmail-client-PM

What This Skill Does

The gmail-client-PM skill serves as a robust bridge between the OpenClaw AI agent and your Gmail account. By leveraging standard IMAP and SMTP protocols, this skill enables seamless email management directly from the command line or via an AI interface. It allows users to stay on top of their communications by listing unread messages, fetching the full text of specific emails using unique identifiers, and composing and sending new messages without needing to switch context to a browser or desktop mail client. It acts as an automation layer that converts natural language requests into structured email operations.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/pierremenard/gmail-client. Once installed, ensure you have configured your environment variables correctly. You must set GMAIL_USER to your email address and GMAIL_PASS to a Google App Password (not your primary password). You can verify the installation by running the script with the help flag to ensure all dependencies are resolved.

Use Cases

This skill is ideal for professionals who need to filter high-volume inboxes or automate routine correspondence. For example, a project manager might use the agent to filter for unread alerts from a specific team member and then immediately send a summary report. It is also highly effective for system administrators who want to programmatically send status alerts or notifications from their agent without building a custom SMTP integration from scratch.

Example Prompts

1. "Check my Gmail for any unread emails and list the subjects so I can see what is urgent."
2. "Read the email with ID 12345 and summarize the main action items requested by the sender."
3. "Send an email to [email protected] with the subject 'Project Update' and the body 'The deployment has been successfully completed.'"

Tips & Limitations

When using this skill, always prioritize security by using App Passwords generated via your Google account settings rather than your main credentials. Note that this skill interacts with Gmail via IMAP/SMTP; while highly reliable, it may be subject to Gmail's rate limits if abused for mass emailing. Ensure your GMAIL_PASS is kept in a secure .env file and never committed to version control. If you have two-factor authentication enabled, you must generate a new App Password specifically for this skill to ensure consistent connectivity.