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.