skills.rest
vivekgoquest
vivekgoquestCOMMUNITY
Explore all skills by this author →
GitHub

google-workspace

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

Updated Aug 22, 2026
Search Tags:#google calendar#Google Sheets#email automation#gmail#OAuth2#google workspace#Google Drive
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill google-workspace-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill google-workspace-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth, google-auth-oauthlib, google-auth-httplib2, httplib2, pyasn1, 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 integrations and handling OAuth flows manually. This Skill provides a ready-made, non-interactive OAuth setup and a unified JSON-output CLI covering Gmail, Calendar, Drive, Contacts, Sheets, and Docs. ## Core Features & Use Cases - Gmail Operations: Search with full Gmail query syntax, read full message bodies, send plain or HTML email, reply in-thread, and manage labels. - Calendar, Drive, Sheets & Docs: List and create timezone-aware 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, revocation, and scope triage across CLI, Telegram, or Discord. - Use Case: Ask for a morning brief and the agent pulls today's calendar events, detects conflicts, finds urgent unread email, and links preparation items to meetings using the bundled daily-brief procedure. ## Quick Start Ask the agent to check Google authentication and show your unread emails from the last 24 hours along with today's calendar events.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I send an email with the Gmail API from the command line?▼

Run the google_api.py script with the gmail send subcommand, passing --to, --subject, and --body arguments, plus --html for HTML content. Authentication uses a stored OAuth2 token created by the setup script, and the result returns JSON with the sent message id and threadId.

How to search Gmail messages using search operators?▼

Use the gmail search command with standard Gmail operators like is:unread, from:, newer_than:, has:attachment, and filename:pdf, combined with AND, OR, NOT, and grouping. The bundled gmail-search-syntax reference documents all supported operators and common query patterns.

Do I need this skill if I only want to read Gmail?▼

No. For email-only access, the himalaya skill is recommended instead because it works with a Gmail App Password and takes about two minutes to set up. This skill is intended when you also need Calendar, Drive, Sheets, or Docs access.

Why does Google OAuth setup fail with Error 403 access_denied?▼

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

Can I use this skill on a headless server without a browser?▼

Yes. The OAuth flow is fully non-interactive: the setup script prints an authorization URL, you open it on any device, and paste back the redirected localhost URL or code. A stored PKCE session lets the token exchange complete later on headless systems.

What happens when the Google token is missing required scopes?▼

The check command reports AUTHENTICATED (partial) and lists the missing scopes, which occurs when new write capabilities were added after initial authorization. Revoke the token with setup.py --revoke and repeat the authorization steps to grant the upgraded scopes.

Related Skills

Explore More Personal & Entrepreneur Skills→
SillyHippySillyHippy

google-direct-oauth

Connects Google Calendar and Gmail via user-owned OAuth credentials with automatic token refresh.

Community
Intermediate
dheejay282002dheejay282002

ai-secretary

Draft emails, manage calendars, and organize tasks using structured productivity workflows.

Community
Advanced
thecloudtipsthecloudtips
18

Meeting Preparation

Generates meeting preparation notes from calendar events and attendee data.

Community
Advanced
InnerScopeHearingInnerScopeHearing

m365-mail

Retrieve accounting documents from Microsoft 365 mailboxes via the Microsoft Graph API.

Official
Intermediate