← Back to Skills Marketplace
37682
Downloads
72
Stars
330
Active Installs
9
Versions
Install in OpenClaw
/install gmail
Description
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail....
Usage Guidance
Install only if you trust Maton to broker access to the selected Gmail account. Review the Google OAuth permissions, use the correct connection when multiple accounts are connected, and require the agent to show the exact email, draft, label, or thread before approving any send, create, update, trash, or delete action.
Capability Analysis
Type: OpenClaw Skill
Name: gmail
Version: 1.0.8
The gmail skill provides integration with the Gmail API via the Maton API gateway (api.maton.ai). The SKILL.md documentation includes clear instructions for the AI agent, specifically mandating explicit user approval for all write operations. The skill uses a managed OAuth approach where requests are proxied through Maton, and no evidence of malicious intent, obfuscation, or unauthorized data exfiltration was found.
Capability Assessment
Purpose & Capability
The stated purpose is to read, send, and manage Gmail messages, threads, labels, and drafts, and the documented capabilities match that purpose. Gmail access is sensitive, but it is clearly disclosed and purpose-aligned.
Instruction Scope
The skill documents read and write Gmail operations, including sending mail, modifying labels, trashing messages, and managing drafts. It explicitly requires user approval before create, update, or delete calls.
Install Mechanism
The artifact is a single non-executable SKILL.md. It optionally instructs users to install the Maton CLI through npm or Homebrew, which is purpose-aligned but requires trusting that external distribution.
Credentials
Network access, MATON_API_KEY, and managed OAuth through api.maton.ai are proportionate for Gmail integration. Email data and OAuth-backed requests are routed through Maton's gateway, which is disclosed.
Persistence & Privilege
OAuth connections can remain active through Maton, but the documentation describes listing, selecting, creating, and deleting connections, making the persistence visible and user-manageable.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail - After installation, invoke the skill by name or use
/gmail - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.8
- Added CLI usage examples throughout documentation for common Gmail operations.
- Included installation instructions for Maton CLI via NPM and Homebrew.
- Expanded Quick Start and Connection Management sections to cover both CLI and Python methods.
- Added specific CLI commands for sending, replying, and forwarding messages, as well as label and thread management.
- Improved organization and clarity for multi-connection scenarios and authentication steps.
v1.0.7
- Updated all API endpoint base URLs from `gateway.maton.ai` and `ctrl.maton.ai` to `api.maton.ai`.
- Clarified that only listed API endpoints are supported.
- Added notes on scoping, explicit user approval for write operations, and improved security instructions.
- Minor example and documentation updates for consistency with the new base URL.
- Removed the LICENSE.txt file.
v1.0.6
- Added clawdbot metadata for skill compatibility and requirements.
- Declared required environment variable (`MATON_API_KEY`) in the metadata section.
- No changes to functional documentation or API usage.
v1.0.5
- Simplified the "Base URL" section and moved critical prefix instructions up front.
- Removed redundant instructions and streamlined the authentication and connection setup guides.
- Clarified troubleshooting steps for API key errors and added troubleshooting for invalid app names.
- Cleaned up and condensed general notes for easier reference.
- No API or functionality changes; documentation only.
v1.0.4
- Clarified base URL requirements to specify that all paths must start with the connection app name (e.g., `/google-mail/...`).
- Added an explicit note emphasizing that the app prefix (such as `/google-mail/`) is required for the gateway to identify the correct connection.
- No other content changes detected.
v1.0.3
- Switched all shell and cURL examples to Python one-liners using `urllib.request` for easier out-of-the-box use.
- Added a new Troubleshooting section for "Invalid API key" errors, including detailed step-by-step instructions and Python test code.
- Updated quick start and connection management instructions with Python equivalents.
- General documentation improvements to streamline getting started and debugging.
v1.0.2
- Added a note in the description recommending the api-gateway skill for integration with third party apps other than Gmail.
- Updated code samples and curl commands to use environment variable syntax ($MATON_API_KEY) for clarity.
- Added important notes about using curl with the -g flag for bracketed URLs and about shell variable expansion issues when piping to jq or other commands.
v1.0.1
- Updated base URL documentation: replace `{endpoint}` with `{native-api-path}` for clarity.
- Expanded connection response example to include `creation_time`, `last_updated_time`, and `metadata` fields.
- Added instructions for specifying a Gmail connection using the `Maton-Connection` header.
- Clarified API key acquisition (sign in or create an account).
- Minor improvements for accuracy and clarity in usage instructions.
v1.0.0
- Initial release of Gmail skill with managed OAuth integration.
- Supports reading, sending, and managing emails, threads, labels, and drafts via the Gmail API.
- API key-based authentication through Maton gateway.
- Includes connection management endpoints and example code in Python and JavaScript.
- Features comprehensive usage instructions, query operators, and error handling documentation.
Metadata
Frequently Asked Questions
What is Gmail?
Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill when users want to interact with Gmail.... It is an AI Agent Skill for Claude Code / OpenClaw, with 37682 downloads so far.
How do I install Gmail?
Run "/install gmail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail free?
Yes, Gmail is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail support?
Gmail is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.0.8.
More Skills