google-workspace

Integrate Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Xerxes-managed OAuth.

27|2|Updated Jan 15, 2024
One-click install
npx skills add https://github.com/erfanzar/Xerxes-Agents --skill google-workspace-erfanzar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/erfanzar/Xerxes-Agents/tree/main/src/python/xerxes/skills/productivity/google-workspace
Command: npx skills add https://github.com/erfanzar/Xerxes-Agents --skill google-workspace-erfanzar

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, Contacts, Sheets, and Docs integration for Xerxes via OAuth, enabling automated workflows across Google Workspace services.

Core Features & Use Cases

  • OAuth-based access: Uses Xerxes-managed OAuth to authorize and refresh access tokens.
  • CLI-first workflow: Executes Google Workspace operations from the Xerxes CLI with optional gws backend or Python client libraries.
  • Use Case: Automate routine tasks like reading Gmail, creating Calendar events, and managing Drive files across platforms.

Quick Start

Run the setup to authorize Google Workspace access, then issue commands via the CLI to manage Gmail, Calendar, Drive, 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 automate Gmail and Google Calendar workflows from the command line?

You can automate Gmail and Google Calendar workflows from the command line by using a CLI setup that authenticates via Xerxes-managed OAuth to execute service-specific API calls. This allows you to read emails and create calendar events programmatically.

Can I use Python client libraries to manage Google Drive files when gws is unavailable?

Yes, you can use Python client libraries to manage Google Drive files when the gws backend is unavailable. The integration includes a compatibility wrapper that falls back to these libraries to handle file operations and ensure continuity.

Does this Google Workspace integration handle OAuth token refresh and scope validation automatically?

Yes, this Google Workspace integration handles OAuth token refresh and scope validation automatically. It uses Xerxes-managed OAuth to authorize tokens and applies scope validation to prevent unauthorized access across Gmail, Drive, and other services.

What's the best way to programmatically access Google Sheets and Docs for bots?

The best way to programmatically access Google Sheets and Docs for bots is through an OAuth-based integration that provides JSON-formatted outputs via scripts. This setup handles authentication management and service-specific API calls for automated platforms.

Do I need google-auth-oauthlib to set up Google Workspace automation?

Yes, you need google-auth-oauthlib along with google-api-python-client and google-auth-httplib2 to set up Google Workspace automation. These dependencies are required for authentication management and executing API calls across the integrated services.

Why does my Google Workspace CLI script return an authentication error?

Your Google Workspace CLI script returns an authentication error due to invalid or expired OAuth tokens. The integration includes error handling and scope validation, requiring you to re-authorize access through the setup process to refresh your credentials.