Google Suite Skill

Version: 1.0.0

Category: Productivity

Description: Unified access to Gmail, Google Calendar, and Google Drive APIs for sending, reading, deleting emails, managing calendar events, and handling files.

Features

Gmail

• Send emails
• Read emails (list, search, get details)
• Delete emails
• Mark as read/unread

Google Calendar

• List events
• Create events
• Update events
• Delete events

Google Drive

• List files
• Upload files
• Download files
• Delete files
• Search files

Setup

Prerequisites

• Python 3.8+
• Google Cloud project with OAuth2 credentials
• Enable Gmail, Calendar, and Drive APIs in Google Cloud Console

Environment Variables

• GOOGLE_OAUTH_CLIENT_ID - OAuth2 client ID
• GOOGLE_OAUTH_CLIENT_SECRET - OAuth2 client secret
• GOOGLE_OAUTH_REDIRECT_URI - OAuth2 redirect URI (e.g., http://localhost:8080/callback)

Required Scopes

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/gmail.send
• https://www.googleapis.com/auth/gmail.modify
• https://www.googleapis.com/auth/calendar
• https://www.googleapis.com/auth/drive

Token Storage

• Tokens are stored in google_suite_tokens.json (by default)

Installation

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

Usage

Authentication

1. On first use, the skill will prompt for OAuth2 authentication.
2. Visit the provided URL, log in, and paste the authorization code.
3. Tokens will be saved for future use.

Example Calls

Send Email

skill.execute({
    "service": "gmail",
    "action": "send",
    "to": "user@example.com",
    "subject": "Test Email",
    "body": "Hello from OpenClaw!"
})

List Emails

skill.execute({
    "service": "gmail",
    "action": "list",
    "query": "from:boss@company.com"
})

Delete Email

skill.execute({
    "service": "gmail",
    "action": "delete",
    "message_id": "XYZ123..."
})

List Calendar Events

skill.execute({
    "service": "calendar",
    "action": "list",
    "days": 7
})

Create Calendar Event

skill.execute({
    "service": "calendar",
    "action": "create",
    "summary": "Team Meeting",
    "start": "2024-03-01T10:00:00",
    "end": "2024-03-01T11:00:00"
})

List Drive Files

skill.execute({
    "service": "drive",
    "action": "list",
    "query": "name contains 'report'"
})

Upload File to Drive

skill.execute({
    "service": "drive",
    "action": "upload",
    "file_path": "./myfile.pdf"
})

Security

• OAuth2 tokens are stored securely and never logged.
• All credentials are loaded from environment variables.
• No sensitive data is printed or logged.

Troubleshooting

• Ensure all required APIs are enabled in Google Cloud Console.
• Check that OAuth2 credentials are correct and match the redirect URI.
• Delete google_suite_tokens.json to force re-authentication if needed.

References

• Google API Python Client
• Gmail API Docs
• Calendar API Docs
• Drive API Docs