skills.rest
maopujie10-sys
maopujie10-sysCOMMUNITY
Explore all skills by this author →
GitHub

google-workspace

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

1|Updated Jun 24, 2026
Search Tags:#google calendar#cli#email automation#gmail#sheets#oauth2#google drive
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill google-workspace-maopujie10-sys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/productivity/google-workspace
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill google-workspace-maopujie10-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Accessing Google Workspace services programmatically requires navigating OAuth2 setup, API enablement, and multiple service-specific SDKs. This Skill consolidates Gmail, Calendar, Drive, Contacts, Sheets, and Docs operations into a single CLI with a guided, non-interactive OAuth setup flow that works over chat platforms. ## Core Features & Use Cases - Gmail Operations: Search with Gmail query syntax, read full messages, send plain or HTML email, reply with proper threading, and manage labels. - Calendar, Drive, Sheets, and Docs: List and create calendar events with timezone-aware times, upload/download/share Drive files, read and write spreadsheet ranges, and create or append to Docs. - Guided OAuth Setup: A step-by-step setup script handles client credentials, auth URL generation, PKCE code exchange, token refresh, and revocation, with scoped service selection. - Use Case: Ask the agent to find unread emails from your boss this week, summarize them, then create a follow-up calendar event and share a related Drive report — all confirmed with you before any write action. ## Quick Start Ask the agent to check whether Google Workspace is authenticated, and if so, search 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 and send Gmail messages from the command line?▼

Use the google_api.py script with commands like gmail search "is:unread" to find messages and gmail send --to --subject --body to send them. All results return as JSON with fields like id, from, subject, and snippet.

How do I set up Google OAuth for CLI API access?▼

Create a Desktop OAuth client in Google Cloud Console, enable the needed APIs, then run setup.py with --client-secret, --auth-url, and --auth-code steps. The token is stored locally and refreshes automatically after the one-time setup.

Can I use Gmail without a Google Cloud project?▼

Yes, for email-only needs use the himalaya skill with a Gmail App Password instead, which takes about two minutes. The google-workspace skill is only needed when you also require Calendar, Drive, Sheets, or Docs access.

Why does Google OAuth return Error 403 access_denied?▼

This error occurs when the OAuth app is still in Testing mode and your Google account is not listed as a test user. Add your account under Audience → Test users in the Google Cloud Console, then retry the authorization URL.

What happens when the Google token is missing scopes?▼

Newer write capabilities like Drive delete or Docs editing require upgraded scopes, shown as AUTHENTICATED (partial). Run setup.py --revoke and repeat the authorization steps to grant the expanded permissions.

Does the skill delete Drive files permanently?▼

By default, drive delete moves files to the trash, which is reversible. Permanent deletion only occurs when you explicitly pass the --permanent flag, and the skill requires user confirmation before any delete action.

Related Skills

Explore More Personal & Entrepreneur Skills→
zaiyemeiyou404zaiyemeiyou404

google-workspace

Manage Gmail, Calendar, Drive, Docs, Sheets, and Contacts via CLI.

Community
Advanced
OpenAEC-FoundationOpenAEC-Foundation
163

frappe-core-notifications

Route Frappe document events to email, system alerts, or real-time updates.

Official
Advanced
ShawhinTShawhinT
40

email-helper

Draft on-brand Gmail replies with correct thread context and formatting.

Community
Advanced
ragnarokhaaragnarokhaa
4

himalaya

Manage email accounts via IMAP/SMTP using the Himalaya CLI.

Community
Intermediate