mailgun-simple
by lksrz
Web & Frontend DevelopmentBrief
Send outbound emails via the Mailgun API.
Description
What This Skill Does
Sends outbound emails through the Mailgun API using the official Mailgun JS SDK. Requires a verified sending domain and API key configured via environment variables.
Uses the official Mailgun SDK directly rather than generic SMTP, giving access to Mailgun-specific delivery tracking and EU/US region routing.
When to Use It
- Sending transactional emails from an agent workflow
- Notifying users when a background job completes
- Dispatching password reset or confirmation emails
- Alerting a team when a monitored threshold is crossed
- Forwarding form submissions to an inbox
Example Workflow
User asks: send an email to user@example.com with subject 'Report Ready' and body 'Your report is attached.'
- 1
Read MAILGUN_API_KEY, MAILGUN_DOMAIN, MAILGUN_REGION, and MAILGUN_FROM from environment
- 2
Initialize Mailgun client with the appropriate regional endpoint
- 3
Construct the message object with to, subject, and text fields
- 4
Call the Mailgun messages API to dispatch the email
Email delivered to user@example.com via Mailgun with a returned message ID
Requirements
- MAILGUN_API_KEY environment variable
- MAILGUN_DOMAIN environment variable (verified sending domain in Mailgun)
- MAILGUN_REGION environment variable (EU or US)
- Mailgun account
Installation
clawhub install lksrz/mailgun-simpleRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.