skills.rest
loteiron
loteironCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

google-workspace

Manage Gmail, Calendar, Drive, Sheets, and Docs through OAuth-authenticated CLI commands.

Updated Sep 10, 2026
Search Tags:#google calendar#Google Sheets#email automation#gmail#OAuth2#google workspace#Google Drive
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill google-workspace-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/loteiron/ZeusAgent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill google-workspace-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth, google-auth-oauthlib, google-auth-httplib2, httplib2, pyasn1, and includes scripts (resource) and references (resource) components.

What problem does it solve? Accessing Google Workspace services from an agent or terminal normally requires writing API client code and handling OAuth flows manually. This Skill provides a ready-made, non-interactive OAuth setup and a single JSON-output CLI covering Gmail, Calendar, Drive, Contacts, Sheets, and Docs. ## Core Features & Use Cases - Gmail operations: Search with Gmail query syntax, read full messages, send plain or HTML email, reply in-thread, and manage labels. - Calendar, Drive, Sheets, and Docs: List and create events with timezone-aware times, upload/download/share/trash Drive files, read and write spreadsheet ranges, and create or append to Docs. - Guided OAuth setup: A step-by-step setup script handles client secrets, PKCE authorization URLs, code exchange, token refresh, and revocation, with partial-scope detection and troubleshooting guidance. - Use Case: Ask the agent for a morning brief: it lists today's calendar events, detects conflicts, searches urgent unread Gmail threads, and drafts replies after your approval. ## Quick Start Ask the agent to check Google Workspace authentication and then show your unread emails from the last 24 hours along with today's calendar events.

Frequently Asked Questions about google-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email with Gmail from the command line?▼

Run google_api.py with the gmail send subcommand, passing --to, --subject, and --body arguments, plus --html for HTML content. The command returns JSON with the sent message id and threadId after OAuth authentication is complete.

How to search Gmail messages using query operators?▼

Use the gmail search subcommand with standard Gmail operators like is:unread, from:, newer_than:, and has:attachment. The references/gmail-search-syntax.md file documents all supported operators and common query patterns.

Do I need this skill if I only want to read Gmail?▼

No. For email-only access, the himalaya skill is simpler: it works with a Gmail App Password and takes about two minutes to set up, with no Google Cloud project or OAuth client required.

Why does Google Workspace authentication fail with access_denied?▼

Error 403 access_denied usually means the OAuth consent screen is in Testing mode and your account is not a test user. Add your Google account under Audience → Test users in Google Cloud Console, then retry the authorization URL.

Can I use this with a Google Advanced Protection account?▼

Yes, but your Workspace admin must first add the OAuth client ID to the organization's allowed apps list. Without that allowlisting, the authorization step will be blocked by Advanced Protection.

What happens when the Google token is missing scopes?▼

The setup check reports AUTHENTICATED (partial) and lists the missing scopes. New write capabilities like Drive delete or Docs create require re-authorization: run setup.py --revoke, then repeat the auth-url and auth-code steps.

Related Skills

Explore More Personal & Entrepreneur Skills→
SillyHippySillyHippy

google-direct-oauth

Connects Google Calendar and Gmail via user-owned OAuth credentials with automatic token refresh.

Community
Intermediate
csuzngjhcsuzngjh
1

pd-daily

Configure and send daily evolution reports via email, messaging, or voice.

Community
Advanced
openaiopenai
5.0k

google-calendar

Inspect Google Calendar availability and draft timezone-aware event-change proposals.

Official
Advanced
decninerdecniner

gmail-automation

Automates Gmail inbox cleanup via IMAP with scan, flag, approve, and delete workflow.

Community
Intermediate