google-workspace

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

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill google-workspace-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/skills/productivity/google-workspace
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill google-workspace-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Accessing Google Workspace services from an AI agent or terminal normally requires writing custom API integration code and handling OAuth flows manually. This Skill provides a ready-made, non-interactive OAuth setup and a unified JSON-output CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs. ## Core Features & Use Cases - Gmail Operations: Search with full Gmail query syntax, read message bodies, send plain or HTML email, reply in threads, and manage labels. - Calendar, Drive, Sheets & Docs: List and create calendar events with timezone handling, upload/download/share Drive files, read and write spreadsheet ranges, and create or append to Docs. - Guided OAuth Setup: A step-by-step, agent-driven setup script handles client credentials, PKCE authorization, token refresh, scope triage, and revocation. - Use Case: Ask the agent to find unread emails from your boss this week, summarize them, create a follow-up calendar event, and save the summary to a Google Doc — all through one authenticated CLI. ## Quick Start Ask the agent to check your Google authentication status and then search your Gmail for unread messages from the last day.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I search and read Gmail messages from the command line?▼

Use the google_api.py CLI with the gmail search command and standard Gmail operators like is:unread or from:sender. It returns a JSON array with id, from, subject, date, and snippet, and gmail get MESSAGE_ID returns the full message body.

How do I set up Google OAuth for a CLI or headless environment?▼

Run setup.py with --client-secret to store your Google Cloud OAuth JSON, then --auth-url to get a consent URL, and --auth-code with the pasted redirect URL to complete the PKCE exchange. The token is saved to ~/.hermes/google_token.json and refreshes automatically.

Can I use this with only Gmail and not the full Workspace scopes?▼

Yes, pass a narrower --services set such as email,calendar during the auth-url step so the consent screen only requests the scopes you need. For email-only use, the documentation recommends the himalaya skill with a Gmail App Password instead.

Why does Google OAuth fail with Error 403 access_denied?▼

Error 403 access_denied means your Google account is not registered as a test user for an OAuth app still in Testing mode. Add your account under Audience → Test users in the Google Cloud Console, then retry the authorization URL.

What happens when the Google token is missing scopes?▼

An AUTHENTICATED (partial) status means the token lacks scopes required for newer capabilities like Drive write or Docs create. Revoke the token with setup.py --revoke and redo the authorization flow to grant the upgraded scopes.