hermes-gmail-send

Send Gmail messages from Hermes using OAuth token workflow.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/AllenZhou/MIRISE --skill hermes-gmail-send
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-gmail-send
Source: https://github.com/AllenZhou/MIRISE/tree/main/agents/hermes-utils/skills/hermes-gmail-send
Command: npx skills add https://github.com/AllenZhou/MIRISE --skill hermes-gmail-send

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Hermes teams need to send Gmail messages from the MIRISE Hermes production workspace without interactive OAuth in cron or headless contexts. This skill provides a standardized, token-driven approach that uses the existing scripts/shared/send_gmail.py workflow to dispatch emails automatically.

Core Features & Use Cases

  • Uses the standardized OAuth token flow and the send_gmail.py script to deliver emails from Hermes prod.
  • Supports both plain body text and stdin-based large bodies, suitable for automation and notifications.
  • Includes pre-flight checks to verify token presence and client secret availability before attempting to send.

Quick Start

Run the Gmail send script with --to, --subject, and --body (or --stdin) to dispatch a message.

Frequently Asked Questions about hermes-gmail-send

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

FAQPage Schema
How do I send automated Gmail messages from a headless cron job without interactive OAuth?▼

To send Gmail from headless cron jobs without interactive OAuth, this skill uses a standardized token-driven workflow via the send_gmail.py script to dispatch emails automatically using pre-configured token files and client secrets.

What do I need to set up before automating Gmail sending in a production workspace?▼

Before automating Gmail sending, you need a valid OAuth token file and a client secret configured in your environment. The skill performs pre-flight checks to verify token presence and client secret availability before attempting to send.

How does the OAuth token workflow handle email automation in Hermes production?▼

The OAuth token workflow handles email automation in Hermes production by applying a standardized, token-driven approach that bypasses interactive login, allowing cron-driven notifications and other automated tasks to dispatch Gmail safely in headless environments.

Can I pipe large email bodies via stdin when sending automated Gmail notifications?▼

Yes, you can pipe large email bodies via stdin when sending automated Gmail notifications. The skill supports both plain body text through the --body flag and stdin-based large bodies through --stdin for automation and notifications.

What are the limitations of using OAuth tokens for automated Gmail in headless environments?▼

A key limitation of using OAuth tokens for automated Gmail in headless environments is the strict dependency on a valid token file and client secret; if these are missing or expired, the pre-flight checks will block the send attempt to prevent failures.