google-workspace

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

16|Updated Sep 22, 2026
One-click install
npx skills add https://github.com/igniteenow/robo --skill google-workspace-igniteenow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/igniteenow/robo/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/igniteenow/robo --skill google-workspace-igniteenow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth, google-auth-oauthlib, google-auth-httplib2, httplib2, pyasn1, and includes scripts (resource) and references (resource) components.

What problem does it solve? Accessing Google Workspace services programmatically requires juggling OAuth2 setup, multiple API clients, and inconsistent tooling. This Skill provides a single JSON-output CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs, with a fully non-interactive OAuth flow that works over CLI, Telegram, or Discord. ## Core Features & Use Cases - Gmail Operations: Search with Gmail query syntax, read full messages, send plain or HTML email, reply in threads, and manage labels. - Calendar, Drive, Sheets, and Docs: List and create events, upload/download/share Drive files, read and write spreadsheet ranges, and create or append to Docs. - Scoped OAuth Setup: A step-by-step setup script supports partial service scopes (e.g., email,calendar only), PKCE exchange on headless systems, token auto-refresh, and revocation. - 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 save the summary to a new Google Doc — all without leaving the chat. ## Quick Start Ask the agent to check your Google authentication status and then search your Gmail for unread messages from the last day.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I search Gmail from the command line?▼

Run the google_api.py script with the gmail search subcommand and a Gmail query string, such as "is:unread newer_than:1d". Results return as a JSON array with id, from, subject, date, and snippet fields.

How do I set up Google OAuth for CLI access to Gmail and Calendar?▼

Create a Desktop OAuth client in Google Cloud Console, download the JSON, then run setup.py with --client-secret, --auth-url, and --auth-code in sequence. The flow is non-interactive and stores a refreshable token at ~/.robo/google_token.json.

Can I use Gmail with just an app password instead of OAuth?▼

Yes, for email-only needs the himalaya skill works with a Gmail App Password and takes minutes to set up without a Google Cloud project. OAuth with this skill is only needed for Calendar, Drive, Sheets, or Docs access.

Why does Google OAuth fail with Error 403 access_denied?▼

Error 403 access_denied means your Google account is not registered as a test user for the OAuth app while it is in Testing mode. Add your account under Audience → Test users in Google Cloud Console, then retry the authorization URL.

Does the skill work on headless servers without a browser?▼

Yes, the OAuth flow uses a localhost redirect with PKCE and stores a pending session, so you can authorize in any browser and paste back the redirected URL or code. The token exchange completes even on headless systems.

Why do Drive uploads not use the gws CLI backend?▼

Drive uploads always use the Python google-api-python-client because gws does not support multipart uploads. All other operations prefer gws when installed and fall back to the Python client otherwise.