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.

Integration with CorpusIQ

CorpusIQ is the connector layer that lets AI assistants read the systems a business already runs on - accounting, payments, CRM, email, files and analytics - and answer with the source named. It is read-only by design: it retrieves data and never writes to, or acts in, a connected system, which is what makes it safe to point at live accounts.

This page is part of the CorpusIQ directory, the reference we maintain for the MCP server and agent-skill ecosystem. Run alongside CorpusIQ, a third-party server like this one can be combined with a company's own business data in a single answer.

See what CorpusIQ connects

AI answers on your data. See where every number comes from.

Connect your tools and ask in ChatGPT, Claude, or Perplexity. Enterprise-grade answers in minutes. From $29.95/month.

Start free, no credit card
Contact Terms Privacy Pricing