Google Suite Skill\r

\r Version: 1.0.0\r Category: Productivity\r Description: Unified access to Gmail, Google Calendar, and Google Drive APIs for sending, reading, deleting emails, managing calendar events, and handling files.\r \r

Features\r

\r

Gmail\r

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

Google Calendar\r

• List events\r
• Create events\r
• Update events\r
• Delete events\r \r

Google Drive\r

• List files\r
• Upload files\r
• Download files\r
• Delete files\r
• Search files\r \r

Setup\r

\r

Prerequisites\r

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

Environment Variables\r

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

Required Scopes\r

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

Token Storage\r

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

Installation\r

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib\r
```\r
\r
## Usage\r
\r
### Authentication\r
1. On first use, the skill will prompt for OAuth2 authentication.\r
2. Visit the provided URL, log in, and paste the authorization code.\r
3. Tokens will be saved for future use.\r
\r
### Example Calls\r
\r
#### Send Email\r
```python\r
skill.execute({\r
    "service": "gmail",\r
    "action": "send",\r
    "to": "[email protected]",\r
    "subject": "Test Email",\r
    "body": "Hello from OpenClaw!"\r
})\r
```\r
\r
#### List Emails\r
```python\r
skill.execute({\r
    "service": "gmail",\r
    "action": "list",\r
    "query": "from:[email protected]"\r
})\r
```\r
\r
#### Delete Email\r
```python\r
skill.execute({\r
    "service": "gmail",\r
    "action": "delete",\r
    "message_id": "XYZ123..."\r
})\r
```\r
\r
#### List Calendar Events\r
```python\r
skill.execute({\r
    "service": "calendar",\r
    "action": "list",\r
    "days": 7\r
})\r
```\r
\r
#### Create Calendar Event\r
```python\r
skill.execute({\r
    "service": "calendar",\r
    "action": "create",\r
    "summary": "Team Meeting",\r
    "start": "2024-03-01T10:00:00",\r
    "end": "2024-03-01T11:00:00"\r
})\r
```\r
\r
#### List Drive Files\r
```python\r
skill.execute({\r
    "service": "drive",\r
    "action": "list",\r
    "query": "name contains 'report'"\r
})\r
```\r
\r
#### Upload File to Drive\r
```python\r
skill.execute({\r
    "service": "drive",\r
    "action": "upload",\r
    "file_path": "./myfile.pdf"\r
})\r
```\r
\r
## Security\r
- OAuth2 tokens are stored securely and never logged.\r
- All credentials are loaded from environment variables.\r
- No sensitive data is printed or logged.\r
\r
## Troubleshooting\r
- Ensure all required APIs are enabled in Google Cloud Console.\r
- Check that OAuth2 credentials are correct and match the redirect URI.\r
- Delete `google_suite_tokens.json` to force re-authentication if needed.\r
\r
## References\r
- [Google API Python Client](https://github.com/googleapis/google-api-python-client)\r
- [Gmail API Docs](https://developers.google.com/gmail/api)\r
- [Calendar API Docs](https://developers.google.com/calendar/api)\r
- [Drive API Docs](https://developers.google.com/drive/api)\r