google-workspace

Integrate Google Workspace services into Hermes via OAuth-managed access.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill google-workspace-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill google-workspace-alexiosbluffmara

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?

Hermes needs to interact with Google Workspace services in a secure, managed way. This skill provides an OAuth-managed integration that enables Hermes to access Gmail, Calendar, Drive, Contacts, Sheets, and Docs, offering a single, consistent interface for automation and task execution.

Core Features & Use Cases

  • Gmail integration: search, read, send, and manage messages via Hermes with optional gws backend.
  • Calendar, Drive, Contacts, Sheets, Docs access: list, create, update, retrieve, and collaborate using JSON outputs.
  • Hermes-managed OAuth flow with a fallback to the Google Workspace CLI when available for broader API coverage; supports multiple platforms (CLI, messaging apps).
  • Use Case: Auto-process emails to create calendar events or update Drive docs, or sync contacts across apps. See References: references/gmail-search-syntax.md

Quick Start

Authenticate using the setup script and then perform a Gmail search to verify integration.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I integrate Google Workspace services like Gmail and Calendar into a Python CLI?

This integration connects Google Workspace services to Hermes via an OAuth-managed flow, using Python client libraries to access Gmail, Calendar, Drive, Contacts, Sheets, and Docs across platforms like CLI, Telegram, or Discord.

What is the best way to automate Gmail message searches and Calendar event creation together?

Automating Gmail searches and Calendar event creation is handled through a unified Hermes interface that applies OAuth-managed access to trigger cross-service workflows using JSON outputs.

Can I use Google Workspace APIs with messaging platforms like Telegram or Discord?

Google Workspace APIs work with messaging platforms like Telegram and Discord by running Hermes with an OAuth-managed integration, using the gws backend or Python client libraries to handle the API requests.

Do I need the gws backend to access Google Drive and Sheets?

The gws backend is optional for accessing Google Drive and Sheets; the integration applies Python Google client libraries as a fallback to ensure full API coverage for retrieving and updating data.

How does the Hermes OAuth flow work for Google Workspace authentication?

The Hermes OAuth flow manages Google Workspace authentication by securely handling token acquisition, enabling automated access to Gmail, Calendar, Drive, Docs, Sheets, and Contacts across supported platforms.

What are the limitations of using Python client libraries versus gws for Google Workspace?

Standard Python client libraries provide reliable API coverage for Google Workspace, but the optional gws backend offers broader API access and enhanced backend capabilities when available in the Hermes environment.