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.