SkillHub

mailgun

v1.0.6

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.

Sourced from ClawHub, Authored by linyishan

Installation

Please help me install the skill `mailgun` from SkillHub official store. npx skills add AlphaFactor/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 <[email protected]>"  # Default sender
export MAILGUN_DEFAULT_TO="[email protected]"  # 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" "[email protected]"

Send with custom sender

mailgun/scripts/send_email.sh "Alert" "System down" "[email protected]" "[email protected]"

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