google-workspace

Manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs through Google's Python API client.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill google-workspace-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill google-workspace-kaminocorp

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 Gmail, Calendar, Drive, Contacts, Sheets, and Docs normally requires switching between apps or building custom integrations. This Skill provides a single OAuth2-authenticated Python CLI that lets an AI agent read, search, send, and modify Google Workspace data on your behalf from any platform. ## 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, Contacts: List and create calendar events with attendees, search Drive files, read and write spreadsheet ranges, extract Docs text, and list contacts. - Non-Interactive OAuth2 Setup: A step-by-step setup script handles PKCE-based authorization, token storage, and automatic refresh, working over CLI, Telegram, or Discord. - Use Case: Ask your agent to summarize unread emails from your boss this week, draft replies for approval, then create a follow-up calendar event with the relevant attendees. ## Quick Start Ask the agent to check your unread Gmail messages from the last 24 hours and it will verify authentication, run the search, and return the results as structured JSON.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I search Gmail from the command line with Python?▼

Use the google_api.py script with the gmail search command and any standard Gmail query, such as "is:unread newer_than:1d". It authenticates with a stored OAuth token and returns matching messages as JSON with sender, subject, date, and snippet fields.

How do I set up OAuth2 for Google Workspace API access?▼

Create a Desktop app OAuth client in Google Cloud Console, enable the Gmail, Calendar, Drive, Sheets, Docs, and People APIs, then run setup.py with --client-secret, --auth-url, and --auth-code. The token is stored locally and refreshes automatically.

Can I use Gmail without a Google Cloud project?▼

Yes, for email-only needs use the himalaya skill with a Gmail App Password instead, which takes about two minutes. The OAuth setup in this skill is only required when you also need Calendar, Drive, Sheets, or Docs access.

Why does Google OAuth fail with Advanced Protection enabled?▼

Accounts enrolled in Google's Advanced Protection Program block unapproved OAuth clients. Your Workspace admin must add the OAuth client ID to the organization's allowed apps list before the authorization step will succeed.

What does REFRESH_FAILED or NOT_AUTHENTICATED mean?▼

NOT_AUTHENTICATED means no token exists yet, so run the setup steps. REFRESH_FAILED means the stored token was revoked or expired, so redo the authorization URL and code exchange steps to obtain a fresh token.