Gmail Integration

Gmail integration - Send emails, manage labels, and automate Gmail workflows with full OAuth2 support

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

1. Go to Google Cloud Console (https://console.cloud.google.com/)
2. Create a new project or select existing
3. Enable Gmail API from API Library
4. 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
5. 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 [e-mail] 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