Skip to content

GWS Gmail

Full Gmail access from the terminal via Google Workspace CLI. Enables Hermes agents to read, search, and send emails programmatically.

Setup

npx skills add googleworkspace/cli@gws-gmail
gws login

Requires Google OAuth. After authentication, the Gmail tools become available to the agent.

Core Capabilities

  • List and search inbox messages with Gmail search syntax
  • Read full message content including attachments
  • Send emails with HTML formatting
  • Manage labels and threads
  • Archive, trash, and modify message state

Hermes Integration

Auto-registers as agent tools. Use in prompts: "Check my inbox for unread messages from the last 24 hours" or "Search for emails about the Q3 report."

Pitfalls

  • OAuth tokens expire after 1 hour. Use refresh token flow for persistent access.
  • Large attachments require base64 decoding.
  • Gmail API quotas: 250 quota units per user per second for reads.

Part of the Hermes Skills Library -- 133+ agent skills. Built by CorpusIQ.

Part of the Hermes Skills Library -- 133+ agent skills. Built by CorpusIQ.

*

This Hermes repo is one of the largest structured collections of public AI, automation, business, and technology documentation. Content remains attributed to original authors and repositories. Indexed and organized by www.CorpusIQ.io.