Agent skill

mailgun

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.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/mailgun

SKILL.md

Mailgun Email Sender

Send emails programmatically using Mailgun's HTTP API.

Prerequisites

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

bash
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:

bash
source ~/.zshrc

Usage

Send a simple email

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

Send to a specific recipient

bash
mailgun/scripts/send_email.sh "Newsletter" "Content here" "[email protected]"

Send with custom sender

bash
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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results