← Back to Skills Marketplace
118
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install lukaizj-gmail
Description
Gmail integration - Send emails, manage labels, and automate Gmail workflows with full OAuth2 support
README (SKILL.md)
Gmail Integration
Gmail integration skill for OpenClaw. Send emails, manage labels, and automate Gmail workflows.
Capabilities
- Send emails via Gmail API
- List recent emails from inbox
- Create and manage custom labels
- Full OAuth2 support for secure authentication
Setup
- Go to Google Cloud Console (https://console.cloud.google.com/)
- Create a new project or select existing
- Enable Gmail API from API Library
- Create OAuth 2.0 credentials:
- Go to "Credentials" → "Create Credentials" → "OAuth client ID"
- Application type: "Desktop app"
- Download the JSON and get client_id and client_secret
- Configure environment variables
Environment Variables
| Variable | Required | Description |
|---|---|---|
GMAIL_CLIENT_ID |
Yes | OAuth Client ID from Google Cloud |
GMAIL_CLIENT_SECRET |
Yes | OAuth Client Secret |
Usage Examples
Send an email to [email protected] with subject "Project Update" and body "The project is complete"
List my recent emails from Gmail
Create a new label named "Projects/OpenClaw"
Message Types
- Plain text emails
- HTML emails (coming soon)
- Emails with attachments (coming soon)
Rate Limits
Google Gmail API has rate limits:
- 100:00 requests per day
- 100 requests per second
Troubleshooting
- "Invalid credentials": Re-check your OAuth credentials
- "Rate limit exceeded": Wait before making more requests
- "Account not verified": Your app needs to go through Google's verification for sensitive scopes
Usage Guidance
This skill claims 'full OAuth2 support' but the code does not perform the OAuth token exchange or include Authorization headers, and it uses an incorrect API path — in short, it won't work as advertised. Before installing: (1) review or request fixes to the code so it implements the OAuth2 flow (authorization code or device flow), exchanges client_id/secret for tokens, and sends 'Authorization: Bearer <access_token>' with requests; (2) test with a throwaway Google account / limited-scope credentials, not your primary account; (3) avoid pasting production client_secret into untrusted skills — if you must provide secrets, ensure you understand where tokens are stored and whether the skill transmits them elsewhere; (4) ask the author to correct endpoint URLs and document token storage/refresh behavior. Because the pieces don't line up, treat this skill as non-functional and review or fix the implementation before giving it real credentials.
Capability Analysis
Type: OpenClaw Skill
Name: lukaizj-gmail
Version: 0.1.0
The Gmail integration skill provides standard functionality for sending emails, listing messages, and managing labels via the Google Gmail API. While the implementation in `gmail.py` is currently non-functional because it lacks the logic to generate and include OAuth2 authorization headers in its requests, there is no evidence of malicious intent, data exfiltration, or prompt injection. The code strictly communicates with official Google API endpoints (gmail.googleapis.com).
Capability Tags
Capability Assessment
Purpose & Capability
The name/description and required env vars (GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET) match a Gmail integration. However, the code never implements an OAuth2 token exchange or attaches Authorization headers to Gmail API calls. The code also uses an incorrect endpoint string (e.g., '.../messages.send' instead of the expected '/messages/send' path), so it cannot actually call Gmail on behalf of a user. Claiming 'Full OAuth2 support' in SKILL.md is inconsistent with the code.
Instruction Scope
SKILL.md instructs you to create OAuth credentials and set env vars, but does not explain how the skill obtains or stores access/refresh tokens, nor how to complete the OAuth consent/redirect flow. The runtime instructions and code do not direct the agent to perform an OAuth handshake or to prompt the user for an authorization code, so runtime behavior will either fail or require ad-hoc manual steps. The instructions are therefore incomplete and grant the agent ambiguous discretion to attempt network calls without proper auth.
Install Mechanism
No install spec or external downloads are included; the skill is instruction-only with a single Python file. That minimizes install-time risk (nothing is fetched or extracted).
Credentials
Requesting GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET is reasonable for an app that performs OAuth. However, those two values alone are insufficient for API access — the code should obtain and use access tokens. There are no other environment variables or unrelated credentials requested, so the scope of requested secrets is narrow but currently misapplied.
Persistence & Privilege
The skill is not marked always:true and does not request system-wide configuration or modify other skills. It does read environment variables at module import, which is normal for credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lukaizj-gmail - After installation, invoke the skill by name or use
/lukaizj-gmail - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of Gmail Integration skill.
- Send emails via the Gmail API.
- List recent emails from your inbox.
- Create and manage custom labels.
- Full OAuth2 support for secure authentication.
- Requires environment variables: GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET.
Metadata
Frequently Asked Questions
What is Gmail Integration?
Gmail integration - Send emails, manage labels, and automate Gmail workflows with full OAuth2 support. It is an AI Agent Skill for Claude Code / OpenClaw, with 118 downloads so far.
How do I install Gmail Integration?
Run "/install lukaizj-gmail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Integration free?
Yes, Gmail Integration is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Integration support?
Gmail Integration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Integration?
It is built and maintained by lukaizj (@lukaizj); the current version is v0.1.0.
More Skills