google-workspace

Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via OAuth.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Harries/hermes-agent --skill google-workspace-harries
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/Harries/hermes-agent/tree/main/skills/productivity/google-workspace
Command: npx skills add https://github.com/Harries/hermes-agent --skill google-workspace-harries

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?

Connect Gmail, Calendar, Drive, Contacts, Sheets, and Docs to Hermes with a managed OAuth flow. This integration reduces context switching by letting you operate your Google Workspace apps directly from Hermes through a consistent JSON interface, whether you’re on CLI, Telegram, or Discord.

Core Features & Use Cases

  • Gmail: search, read, send, reply, and label management across your inbox.
  • Calendar: list, create, and delete events with timezone-aware scheduling.
  • Drive: search files and retrieve metadata for quick access.
  • Contacts: list your contacts from Google Contacts.
  • Sheets & Docs: read sheet ranges, update values, and fetch document text.
  • Use Case: schedule weekly summaries by aggregating data from Sheets and Docs and emailing results to a distribution list.

Quick Start

Ask Hermes to connect your Google account and fetch your unread Gmail messages.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I control Google Workspace apps like Gmail and Calendar from a single interface?

You can search, read, send, and reply to Gmail messages programmatically by using an OAuth-based integration that routes requests through a managed flow with a CLI backend and Python client fallback, returning consistent JSON payloads for your inbox operations.

Can I read and update Google Sheets data as well as fetch Docs text?

Yes, you can read Google Sheets ranges, update values, and append data, as well as fetch document text from Google Docs, all coordinated through a consistent JSON interface via OAuth authentication.

How do I set up OAuth authentication to access Google Drive and Contacts?

OAuth authentication setup for Google Drive and Contacts access is coordinated through a first-time setup process that handles token management automatically, enabling file search, metadata retrieval, and contact listing directly from your interface.

Does this Google Workspace integration support timezone-aware scheduling for Calendar events?

Yes, the Calendar integration supports timezone-aware scheduling, allowing you to list, create, and delete calendar events with accurate timezone handling through a consistent JSON payload structure.

What is the best way to manage Gmail labels and modify email attributes in bulk?

The best way to manage Gmail labels and modify email attributes is through an OAuth-authenticated interface that coordinates per-service operations, letting you modify and label messages while returning consistent JSON responses across CLI, Telegram, or Discord environments.

Do I need Python dependencies to use Google Workspace access via OAuth?

Yes, you need Python dependencies including google-api-python-client, google-auth-oauthlib, and google-auth-httplib2 to use the Python client fallback for Google Workspace access via OAuth authentication.