gsuite-sdk
by pabloalaniz
Web & Frontend DevelopmentBrief
Interact with Google Workspace APIs (Gmail, Calendar, Drive, Sheets) using gsuite-sdk.
Description
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
User asks: show me unread emails from GitHub in the last 7 days
- 1
Check auth status with GoogleAuth().is_authenticated()
- 2
Initialize Gmail client with the authenticated GoogleAuth instance
- 3
Build a search query combining from_("notifications@github.com") and newer_than(days=7)
- 4
Iterate results and print sender, subject, date, and body preview
List of matching Gmail messages with sender, subject, date, and 200-char preview
Requirements
- GOOGLE_CREDENTIALS_FILE environment variable
- credentials.json file downloaded from Google Cloud Console
- Google Cloud project with OAuth 2.0 client configured for Workspace APIs
Installation
clawhub install pabloalaniz/gsuite-sdkRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.