google-workspace

Manage Gmail, Calendar, Drive, Sheets, and Docs through OAuth-authenticated CLI commands.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill google-workspace-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill google-workspace-avatar-arts

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? Accessing Gmail, Calendar, Drive, Contacts, Sheets, and Docs from an AI agent normally requires juggling multiple Google APIs, OAuth flows, and SDKs. This Skill provides a single authenticated CLI interface that handles the entire OAuth2 setup non-interactively and exposes every service through simple JSON-returning commands. ## Core Features & Use Cases - Full Gmail operations: Search with Gmail query syntax, read full message bodies, send plain or HTML email, reply with proper threading, and manage labels. - Calendar, Drive, Sheets, and Docs management: List and create events, upload/download/share Drive files, read and write spreadsheet ranges, and create or append to Docs. - Non-interactive OAuth setup: A step-by-step setup script works over CLI, Telegram, or Discord, with PKCE support for headless systems and automatic token refresh. - Use Case: Ask the agent to find unread emails from your boss this week, summarize them, create a follow-up calendar event with attendees, and log the action items into a Google Sheet — all in one conversation. ## Quick Start Ask the agent to check your Google authentication status and then list your unread emails from the last 24 hours.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I search and read Gmail messages from the command line?

Run the google_api.py script with the gmail search command and a Gmail query such as "is:unread newer_than:1d" to get a JSON array of matching messages. Then use gmail get with a message ID to retrieve the full body text.

How do I set up Google OAuth for a headless or CLI-only environment?

Run setup.py with --client-secret to store your OAuth client file, then --auth-url to get an authorization URL. Open it in any browser, paste back the redirected URL or code to --auth-code, and the PKCE exchange completes without a local server.

Do I need the gws CLI installed to use Google Workspace APIs?

No. The google_api.py script uses gws when it is available for broader coverage, but falls back to the google-api-python-client library automatically. Both paths return the same JSON output contract.

Why does my Google token show AUTHENTICATED (partial) or missing scopes?

This happens when the stored token was granted fewer scopes than the skill requires, often after new write capabilities were added. Revoke the token with setup.py --revoke and repeat the authorization flow to grant the upgraded scopes.

Can I use this for Gmail only without a Google Cloud project?

For email-only needs, the himalaya skill is a better fit since it works with a Gmail App Password and takes minutes to set up. The google-workspace skill is intended when you also need Calendar, Drive, Sheets, or Docs access.