What it does

Provides a Python CLI wrapper to interact with Google Workspace APIs (Gmail, Calendar, Drive, Sheets, Docs, Contacts). Includes setup scripts for OAuth2 authorization and token refresh, plus utilities to search and read Gmail, manage calendar events, read/write Sheets, and access Drive files. Returns JSON for all operations to make automation and parsing simple.

When to use it

Use this skill when an agent needs to read or search email, list or create calendar events, manipulate Drive files or Sheets, or access contacts programmatically. Appropriate when OAuth setup is acceptable and the agent can guide a user through one-time authorization. Not for headless use without completing OAuth setup.

What's included

Scripts: scripts/setup.py for OAuth setup, scripts/google_api.py CLI wrapper to call APIs
References: gmail-search-syntax.md and other docs in references/
Instructions: detailed step-by-step setup for creating OAuth credentials, exchanging codes, verification, and usage examples for Gmail, Calendar, Drive, Sheets, and Docs.