google-workspace

Manage Gmail, Calendar, Drive, Docs, and Sheets via a CLI with OAuth authentication.

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

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?

This Skill simplifies the management of Google Workspace applications (Gmail, Calendar, Drive, Docs, Sheets) by providing a CLI interface, enabling quick access and control over various Google Workspace functionalities.

Core Features & Use Cases

  • Unified Access: Access all Google Workspace apps via a single, integrated command-line interface.
  • OAuth Authentication: Manages OAuth authentication for Google Workspace access, ensuring secure API usage.
  • Use Case: If you frequently need to search your Gmail, manage calendar events, or upload files to Google Drive, this skill allows you to perform these tasks more efficiently, even without a full browser interface.

Quick Start

Run gws gmail search "is:unread" --max 10 to search for unread emails.

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 apps like Gmail and Calendar from the command line?

To manage Google Workspace apps via CLI, you use an interface that integrates with Google Workspace APIs to handle OAuth authentication and control Gmail, Calendar, Drive, Docs, and Sheets. You run commands like `gws gmail search` to execute repetitive tasks efficiently.

Do I need Google API client libraries to automate Google Workspace tasks?

Yes, automating Google Workspace tasks via CLI requires the google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 libraries to handle OAuth2 credentials and enable secure API communication.

What is the best way to automate repetitive Gmail and Google Drive workflows?

The best way to automate repetitive Gmail and Drive workflows is using a CLI that integrates with Google Workspace APIs, allowing you to search emails and upload files efficiently without a full browser interface.

Can I search unread Gmail emails using a command line interface?

Yes, you can search unread Gmail emails using a CLI by running commands such as `gws gmail search "is:unread" --max 10` to quickly retrieve and filter your inbox data programmatically.

How does OAuth authentication work for Google Workspace CLI tools?

OAuth authentication for Google Workspace CLI tools works by requiring Google Workspace OAuth2 credentials, managing the token generation and refresh process automatically to ensure secure and continuous API usage.

Are there limitations when using a CLI for Google Docs and Sheets management?

A limitation of using a CLI for Google Docs and Sheets management is the strict requirement for Python dependencies and OAuth2 credentials, making it unsuitable for environments lacking local Python configuration or browser access.