ClawHub

mailgun sender

Send emails via Mailgun API. Use when the user needs to send emails programmatically, such as newsletters, notifications, alerts, or automated reports. Requires MAILGUN_API_KEY and MAILGUN_DOMAIN environment variables to be configured.

Audits

Pass
ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install mailgun

Mailgun Email Sender

Send emails programmatically using Mailgun's HTTP API.

Prerequisites

Configure the following environment variables in ~/.zshrc or ~/.bash_profile:

export MAILGUN_API_KEY="key-xxxxx"      # Your Mailgun private API key
export MAILGUN_DOMAIN="mg.yourdomain.com"  # Your Mailgun domain
export MAILGUN_FROM="Sender <noreply@mg.yourdomain.com>"  # Default sender
export MAILGUN_DEFAULT_TO="you@email.com"  # Default recipient (optional)

Then reload your shell configuration:

source ~/.zshrc

Usage

Send a simple email

mailgun/scripts/send_email.sh "Subject" "Email body text"

Send to a specific recipient

mailgun/scripts/send_email.sh "Newsletter" "Content here" "recipient@email.com"

Send with custom sender

mailgun/scripts/send_email.sh "Alert" "System down" "admin@company.com" "alerts@company.com"

Features

  • Simple command-line interface
  • Uses environment variables for configuration
  • Supports custom sender and recipient
  • Returns success/error status codes
  • Works with HTML content (pass HTML in body parameter)

Common Use Cases

  • Daily/weekly newsletters
  • System alerts and notifications
  • Automated reports
  • Confirmation emails
  • Scheduled reminders

Troubleshooting

Error: MAILGUN_API_KEY and MAILGUN_DOMAIN must be set → Configure environment variables as shown in Prerequisites

Error: 401 Unauthorized → Check that your API key is correct and active

Error: 404 Not Found → Verify your MAILGUN_DOMAIN is correct

References