google-workspace

Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via OAuth2 with automatic token refresh.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/nelohenriq/hermes-agent-plus --skill google-workspace-nelohenriq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/nelohenriq/hermes-agent-plus/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/nelohenriq/hermes-agent-plus --skill google-workspace-nelohenriq

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?

Gmail, Calendar, Drive, Contacts, Sheets, and Docs are powerful but manual workflows slow down teams. This Skill provides a unified Python-based integration that lets Hermes orchestrate actions across Google Workspace without external binaries and with automatic token refresh.

Core Features & Use Cases

  • OAuth2-based authentication with automatic token refresh across Gmail, Calendar, Drive, Sheets, Docs, and Contacts.
  • Scripted access via Python to search, read, create, and modify Gmail messages; manage calendar events; access Drive files; read and write Sheets and Docs content.
  • Use Case: automatically log a meeting to your calendar and fetch relevant Drive files for a project when a task is created in Hermes.

Quick Start

Run the setup script to authorize Hermes to access your Google Workspace data.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I automate Google Workspace workflows like Gmail and Calendar using Python?

You can automate Google Workspace workflows by using OAuth2-based Python scripts to access Gmail, Calendar, Drive, Sheets, Docs, and Contacts. This integration lets you orchestrate actions like emailing, scheduling, and file retrieval directly without external binaries.

Does this Google Workspace integration work with Telegram and Discord?

Yes, the Google Workspace integration works across Telegram, Discord, and other platforms. It uses a unified Python-based approach to apply automated workflows like emailing and scheduling seamlessly across your chosen communication channels.

Do I need Google OAuth client secrets to manage Gmail and Drive files?

Yes, you need Google OAuth client secrets to securely manage Gmail and Drive files. The integration requires these secrets along with a Hermes home directory for token storage and specific Python client libraries to operate.

What is the best way to handle token refresh for Google Calendar and Sheets API?

The best way to handle token refresh for Google Calendar and Sheets API is through an OAuth2-based integration with automatic token refresh. This mechanism maintains secure access across Workspace services without requiring manual re-authentication.

What Python dependencies are required for Google Workspace automation?

Google Workspace automation requires the Python client libraries google-api-python-client, google-auth-oauthlib, and google-auth-httplib2. These dependencies enable secure OAuth2 authentication and scripted interactions with Google services.

Can I automatically create calendar events and fetch Drive files from a single script?

Yes, you can automatically log a meeting to your calendar and fetch relevant Drive files for a project from a single Python script. This unified integration orchestrates actions across Google Workspace services to automate multi-step document and scheduling tasks.