- name
- mailgun
- description
- 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.
- env
- homepage
- https://github.com/openclaw/openclaw
- repository
- https://github.com/openclaw/openclaw
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 ~/.zshrcUsage
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
- Mailgun Documentation: https://documentation.mailgun.com/
- API Reference: See references/api.md