google-workspace

Provide unified CLI access to Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill google-workspace-daddyelonmusk69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/DaddyElonMusk69/motis-agent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill google-workspace-daddyelonmusk69

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?

Centralizes and automates access to Google Workspace services so an agent can perform email triage, calendar management, file search, contacts lookup, spreadsheet reads/updates, and document retrieval without manual OAuth juggling.

Core Features & Use Cases

  • Unified CLI wrapper: A backward-compatible Python wrapper delegates to the gws CLI to provide consistent commands across Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
  • Non-interactive OAuth and token refresh: Setup and bridge scripts handle client secret storage, authorization URL generation, token exchange, automatic refresh, and revocation for profile-scoped tokens.
  • Practical scenarios: Use it to triage unread messages, create or delete calendar events with timezone-aware ISO timestamps, search Drive for reports, or read and append Sheets programmatically.

Quick Start

Run the setup script to store your OAuth client credentials, obtain the authorization URL, paste back the authorization code, and then use the provided API wrapper to run Gmail, Calendar, Drive, Contacts, Sheets, and Docs commands.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I manage Gmail, Calendar, and Drive from the command line?

Unified CLI access to Google Workspace services is provided through a Python wrapper that delegates to the gws CLI, enabling agent-driven email triage, calendar management, and file search without manual OAuth juggling.

How do I automate OAuth2 token refresh for Google Workspace APIs?

OAuth2 token refresh for Google Workspace APIs is handled by setup and bridge scripts that manage client secret storage, authorization URL generation, token exchange, and automatic refresh for profile-scoped tokens.

Can I read and append Google Sheets programmatically via CLI?

Yes, you can read and append Google Sheets programmatically via the unified gws CLI wrapper, which supports spreadsheet operations alongside Gmail, Calendar, Drive, Docs, and Contacts commands.

Do I need a gws binary installed to use Google Workspace CLI automation?

Yes, Google Workspace CLI automation requires an installed gws binary, OAuth2 client credentials, and a refreshable token file managed by the provided setup and bridge scripts.

What's the best way to triage unread Gmail messages using an agent workflow?

Triage unread Gmail messages using an agent workflow by running the unified CLI wrapper, which applies agent-driven commands to search, read, and manage emails without manual OAuth juggling.

How do I create timezone-aware calendar events from the command line?

Create timezone-aware calendar events from the command line by passing ISO timestamps to the gws CLI wrapper, which handles calendar management operations including event creation and deletion.