google-workspace

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

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill google-workspace-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/productivity/google-workspace
Command: npx skills add https://github.com/luckybbjason1/trading --skill google-workspace-luckybbjason1

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, Sheets, and Docs programmatically requires juggling OAuth setup, multiple Google APIs, and inconsistent tooling. This Skill provides a single authenticated CLI interface for all major Google Workspace services, with a fully non-interactive setup flow that works over CLI, Telegram, or Discord. ## Core Features & Use Cases - Gmail Operations: Search with Gmail query syntax, read full messages, send plain or HTML email, reply in threads, and manage labels. - Calendar, Drive, Sheets & Docs: List and create calendar events, search/upload/download/share Drive files, read and write spreadsheet ranges, and create or append to Docs. - Guided OAuth Setup: Step-by-step non-interactive OAuth2 flow with PKCE, scope triage, token auto-refresh, and revocation support. - 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 interface. ## 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 send Gmail messages from the command line?

Use the google_api.py script with Gmail search operators like 'is:unread' or 'from:[email protected]' to find messages, then 'gmail send' with --to, --subject, and --body flags to send. All commands return structured JSON output.

How do I set up Google OAuth for CLI API access?

Create an OAuth 2.0 Desktop client in Google Cloud Console, download the client secret JSON, then run setup.py with --client-secret, --auth-url, and --auth-code in sequence. The token is stored at ~/.hermes/google_token.json and refreshes automatically.

Can I use Google Workspace APIs without the gws CLI installed?

Yes. The google_api.py script prefers the gws CLI when available but falls back to the Python google-api-python-client library automatically. Both backends produce the same JSON output contract.

Why does my Google token show AUTHENTICATED (partial) or missing scopes?

This happens when the token was authorized before new scopes like Drive write or Docs create were added. Run setup.py --revoke, then redo the auth-url and auth-code steps to grant the upgraded scopes.

What should I use for email-only access instead of full Google Workspace setup?

For email-only needs, use the himalaya skill with a Gmail App Password instead. It takes about two minutes to configure and requires no Google Cloud project or OAuth client.