google-workspace

Manage Gmail, Calendar, Drive, Sheets, Docs, and Contacts via CLI and Python.

Updated May 3, 2026

Search Tags:#oauth #cli #gmail #docs #calendar #drive #google-workspace

Ready to run

npx skills add https://github.com/JuanMS20/solviora-agent --skill google-workspace-juanms20

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/JuanMS20/solviora-agent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/JuanMS20/solviora-agent --skill google-workspace-juanms20

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?

Gmail, Calendar, Drive, Docs, and Sheets are accessed and controlled from Hermes without switching between multiple apps or duplicating credentials.

Core Features & Use Cases

Unified CLI for Gmail, Calendar, Drive, Docs, Sheets, and Contacts using the gws backend when available, with a Python fallback.
Non-interactive OAuth setup and token management to keep access seamless across sessions.
Use cases include automating weekly reports, provisioning documents, and querying calendar events from terminal or chat interfaces.

Quick Start

Install the skill, run the OAuth setup to authorize Google Workspace, and then start issuing gws-backed commands to manage Gmail, Calendar, Drive, Sheets, and Docs.

Frequently Asked Questions about google-workspace

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

FAQPage Schema

How do I manage Google Workspace services like Gmail and Calendar from the command line?▼

You can manage Google Workspace services like Gmail and Calendar from the command line by using the gws CLI backend with Python fallback, authorizing access via a non-interactive OAuth setup.

How do I set up OAuth for Google Workspace CLI access?▼

OAuth setup for Google Workspace CLI access requires client secrets and a token configured in the Hermes home directory, enabling non-interactive token refresh mechanics to maintain seamless sessions.

Can I automate Google Drive and Docs management using Python?▼

Yes, you can automate Google Drive and Docs management using Python through the google-api-python-client library, which serves as a fallback interface when the gws backend is unavailable.

Does Google Workspace CLI work without the gws backend?▼

Google Workspace CLI adapts to environments without the gws backend by falling back to Python interfaces using google-auth-oauthlib, ensuring continuous access to Sheets and Contacts.

What dependencies do I need to control Google Workspace from a terminal?▼

To control Google Workspace from a terminal, you need the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 dependencies to handle API requests and OAuth authentication.

What are the limitations of using CLI for Google Workspace automation?▼

Limitations include requiring initial client secrets and token configuration for Hermes, and functionality depends on the gws backend being available or falling back to Python scripts for operations.