google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs via the gws CLI.

247|22|Updated Dec 11, 2024
One-click install
npx skills add https://github.com/graniet/kheish --skill google-workspace-graniet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/graniet/kheish/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/graniet/kheish --skill google-workspace-graniet

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?

Manually switching between Gmail, Calendar, Drive and other Google Workspace interfaces to complete routine tasks is slow, disjointed and prone to human error. This Skill eliminates that friction by providing a single, automated interface to access and manage all core Google Workspace services without repeated logins or manual UI navigation.

Core Features & Use Cases

  • Unified Service Access: Interact with 6+ core Google Workspace services (Gmail, Calendar, Drive, Contacts, Sheets, Docs) via a single CLI, with automatic OAuth2 token refresh to avoid repeated authentication steps.
  • Backward Compatibility: Maintains existing Kheish skill interfaces for Google Workspace operations, so prior workflows continue to work without modification.
  • Cross-Platform Setup: Fully non-interactive OAuth setup works on CLI, Telegram, Discord and other surfaces, with support for partial service scopes if users only need a subset of Google tools.
  • Common Use Cases: Automatically triage unread Gmail, schedule calendar events, search for files in Drive, update Sheets rows, retrieve Docs content and pull contact information without manual navigation.

Quick Start

Use the google-workspace skill to search your Gmail for all unread emails received in the last 24 hours, then list the top 5 results with sender, subject and date.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Gmail triage and Calendar scheduling without manual UI navigation?

Automate Gmail triage and Calendar scheduling without manual UI navigation by using a single CLI interface to manage core Google Workspace services. This eliminates disjointed multi-app workflows through delegated API calls with automatic OAuth2 token refresh.

Can I manage Google Drive, Sheets, and Docs from a single command line interface?

Manage Google Drive, Sheets, and Docs from a single command line interface by executing delegated API calls across 6+ core Google Workspace services. This provides a unified access point for file search, spreadsheet updates, and document retrieval without repeated logins.

Do I need valid Google OAuth2 credentials to access Workspace apps like Gmail and Contacts?

Valid Google OAuth2 credentials with appropriate service scopes are required to access Workspace apps like Gmail and Contacts. The system performs automatic token refresh during delegated API calls, but the initial OAuth setup is mandatory to authorize the CLI.

Does the Google Workspace automation CLI support partial service scopes for specific tools?

The Google Workspace automation CLI supports partial service scopes for specific tools, allowing users to authorize only a subset of Google services. This non-interactive OAuth setup works across CLI, Telegram, and Discord surfaces for flexible cross-platform deployment.

What is the best way to search unread emails from the last 24 hours in Gmail programmatically?

The best way to search unread emails from the last 24 hours in Gmail programmatically is via the unified Workspace CLI. It retrieves sender, subject, and date for the top results, replacing manual email sorting with automated API queries.

Why does Google Workspace API automation require the Kheish runtime environment?

Google Workspace API automation requires the Kheish runtime environment to execute delegated API calls and manage automatic token refresh. This dependency ensures backward compatibility for existing skill interfaces and maintains stable cross-platform OAuth authentication.