| 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
