google-workspace

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

Updated May 18, 2026
One-click install
npx skills add https://github.com/ossoolli/Nexum-Core --skill google-workspace-ossoolli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/ossoolli/Nexum-Core/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/ossoolli/Nexum-Core --skill google-workspace-ossoolli

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 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: 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 with attendees, and log the action items into a Google Sheet — all through one authenticated CLI. ## Quick Start Ask the agent to check Google Workspace authentication 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 gmail search followed by a Gmail query such as "is:unread newer_than:1d" to get a JSON list of messages, then gmail get with a message ID to read the full body. Authentication must be completed first via the setup script.

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

Create a Desktop 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 in sequence. The token is stored at ~/.hermes/google_token.json and refreshes automatically.

Can I use Gmail with just an app password instead of OAuth?▼

Yes, for email-only needs the documentation recommends the himalaya skill, which works with a Gmail App Password and requires no Google Cloud project. OAuth setup is only needed when you also require Calendar, Drive, Sheets, or Docs access.

Does this work on headless servers without a browser?▼

Yes, the OAuth flow is fully non-interactive and PKCE-based. The user opens the authorization URL on any device, then pastes back the redirected localhost URL or code, which the setup script exchanges for a token.

Why does token refresh fail with REFRESH_FAILED or missing scopes?▼

REFRESH_FAILED means the token was revoked or expired and requires re-running the authorization steps. Missing-scope warnings occur when the user granted only partial consent; revoke the token and re-authorize to grant the upgraded scopes.