google-workspace

Automates Gmail, Calendar, Drive, Contacts, Sheets, and Docs operations via Google API Python scripts.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill google-workspace-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill google-workspace-mlt-oss

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? Managing email, calendar events, files, contacts, and spreadsheets across Google Workspace requires switching between many apps and manual clicks. This Skill lets an AI agent perform all of these operations programmatically through Google's official APIs with a single OAuth2 setup. ## Core Features & Use Cases - Gmail Automation: 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/write/append spreadsheet ranges, extract Docs text, and list contacts. - Non-Interactive OAuth2 Setup: A step-by-step agent-driven setup script handles client credentials, PKCE authorization, token exchange, automatic refresh, and revocation — works on CLI, Telegram, Discord, or headless systems. - Use Case: Ask the agent to find unread emails from your boss this week, summarize them, draft replies for your approval, and add a follow-up event to your calendar — all in one conversation. ## 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?

Run the google_api.py script with the gmail search command and a standard Gmail query like "is:unread newer_than:1d". It returns JSON with message IDs, senders, subjects, and snippets; use gmail get with a message ID to read the full body.

How do I set up Google OAuth2 for Gmail and Calendar API access?

Create an OAuth 2.0 Desktop 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 in the Hermes home directory and refreshes automatically.

Can I use Gmail without a Google Cloud OAuth project?

Yes, for email-only needs use the himalaya skill with a Gmail App Password instead, which takes about two minutes and requires no Google Cloud project. The OAuth setup in this skill is only needed for Calendar, Drive, Sheets, and Docs access.

Why does the Google API return HttpError 403 Insufficient Permission?

This error means the stored token is missing a required API scope. Revoke the current token with setup.py --revoke and repeat the authorization flow so all required scopes are granted during consent.

Does the OAuth flow work on headless servers without a browser?

Yes, the setup script uses a localhost redirect with PKCE and stores a pending session file. The user opens the printed URL on any device, then pastes back the redirect URL or code, which the agent exchanges for a token.

What happens if my Google account uses Advanced Protection?

Accounts enrolled in Advanced Protection require a Workspace administrator to allowlist the OAuth client ID before authorization will succeed. The skill's setup instructions flag this upfront so users can coordinate with their admin first.