Setup & Installation
openclaw skills install @pabloalaniz/gsuite-sdk
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install gsuite-sdk
What This Skill Does
Wraps Google Workspace APIs (Gmail, Calendar, Drive, Sheets) into a single Python SDK with a CLI. Handles OAuth token storage and refresh after first login. Works in scripts, agents, or from the command line.
Covers all four major Workspace services under one auth flow instead of wiring up each Google API client library separately.
When to use it
- Read and search unread Gmail messages by sender or date
- Create calendar events with attendees and notifications
- Upload files to a specific Google Drive folder
- Read spreadsheet ranges as dictionaries for data processing
- Send emails with PDF attachments from automated scripts
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: show me unread emails from GitHub in the last 7 days
AGENT
- 1Check auth status with GoogleAuth().is_authenticated()
- 2Initialize Gmail client with the authenticated GoogleAuth instance
- 3Build a search query combining from_("notifications@github.com") and newer_than(days=7)
- 4Iterate results and print sender, subject, date, and body preview
OUTPUT
List of matching Gmail messages with sender, subject, date, and 200-char preview
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
GOOGLE_CREDENTIALS_FILE environment variablecredentials.json file downloaded from Google Cloud ConsoleGoogle Cloud project with OAuth 2.0 client configured for Workspace APIs