By name: google-workspace description: Unified access to Gmail, Google Calendar, Drive, Docs, Sheets, and Contacts. Use when the user mentions email, calendar, documents, spreadsheets, or Google services. version: "1.0.0" license: MIT compatibility: Requires Google Workspace account and OAuth credentials metadata: author: hermeshub hermes: tags: [gmail, google-calendar, google-drive, google-docs, google-sheets] category: productivity required_environment_variables:
- name: GOOGLE_CLIENT_ID prompt: Google OAuth Client ID help: Create at https://console.cloud.google.com/apis/credentials required_for: full functionality
- name: GOOGLE_CLIENT_SECRET prompt: Google OAuth Client Secret help: From the same OAuth credentials page required_for: full functionality
Google Workspace Integration
Complete access to Google Workspace services through a single skill.
When to Use
- User mentions email, Gmail, inbox, or sending messages
- User asks about calendar, schedule, events, or meetings
- User references Google Drive, Docs, Sheets, or file management
- User wants to search or organize Google Workspace content
Supported Services
Gmail
- Search and read emails with advanced query syntax
- Compose, reply, and forward messages
- Manage labels and filters
- Summarize unread messages
Google Calendar
- List upcoming events and check availability
- Create, update, and delete events
- Set reminders and recurring events
- Find free slots across calendars
Google Drive
- Search files by name, type, or content
- Upload, download, and organize files
- Share files and manage permissions
- Create folders and move files
Google Docs
- Create new documents from templates or scratch
- Read and search document content
- Append or modify existing documents
Google Sheets
- Read and analyze spreadsheet data
- Write data to specific cells or ranges
- Create charts and summaries
- Run formulas and data transformations
Procedure
- Check if Google OAuth credentials are configured
- If not, guide user through setup at https://console.cloud.google.com
- Use appropriate Google API for the requested service
- Format results clearly with relevant metadata
- For multi-service requests, batch operations where possible
Pitfalls
- OAuth tokens expire — handle refresh automatically
- Rate limits apply per API — implement exponential backoff
- Large file downloads should stream to disk, not memory
- Calendar timezone handling requires explicit user timezone
Verification
- Confirm operation completed by reading back the result
- For email sends, verify the message appears in Sent
- For calendar events, confirm the event exists with correct details