gmail

What This Skill Does

The gmail skill provides a seamless integration with the Gmail API, allowing you to read, send, and manage your emails, threads, labels, and drafts directly through the OpenClaw AI agent. By leveraging managed OAuth via the Maton gateway, the skill abstracts away the complexities of token refreshing and authentication headers, allowing you to perform sophisticated email operations as if you were communicating directly with Google’s servers. It acts as a secure proxy, injecting your authorized credentials into requests sent to https://gateway.maton.ai/google-mail/, effectively bridging your AI agent with your personal or business Gmail inbox.

Installation

To integrate this skill into your environment, use the OpenClaw installation command: clawhub install openclaw/skills/skills/bobbyzzhao/gmail-1-0-6

Ensure you have your MATON_API_KEY configured in your environment variables. You must initialize your Google OAuth connection by visiting https://ctrl.maton.ai to ensure the gateway has the necessary permissions to access your mail data.

Use Cases

This skill is perfect for automating repetitive communication tasks. You can use it to build an intelligent assistant that automatically summarizes long email threads, organizes your inbox by applying specific labels to incoming messages, or prepares draft responses based on data fetched from other services. It is particularly useful for developers or power users who want to build custom email workflows—such as weekly reporting bots—without manually managing Google Cloud Platform projects or complex OAuth implementation details.

Example Prompts

1. "Check my inbox for the last 5 unread messages and provide a brief summary of what they are about."
2. "Find the thread from 'Project Alpha' and send a reply saying that I have received the documents and will review them by tomorrow."
3. "Create a new label called 'Invoices' and move all messages containing the word 'receipt' from the last month into that label."

Tips & Limitations

• Authentication: Always ensure your MATON_API_KEY is kept secure. If requests fail, check the status of your connection at https://ctrl.maton.ai to see if the OAuth token has expired or requires re-authorization.
• Rate Limiting: Since this skill proxies to the official Gmail API, it is subject to standard Google API quotas. Avoid creating excessive loops that perform high-frequency read/write operations.
• Scope: This skill is focused specifically on Gmail. If you need to interact with non-Google email services or other third-party APIs, use the api-gateway skill instead.