← Back to Skills Marketplace
756
Downloads
2
Stars
0
Active Installs
16
Versions
Install in OpenClaw
/install mailgun-simple
Description
Send outbound emails via the Mailgun API. Uses MAILGUN_API_KEY, MAILGUN_DOMAIN, MAILGUN_REGION, and MAILGUN_FROM.
README (SKILL.md)
Mailgun Simple
Send outbound emails using the official Mailgun JS SDK.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
MAILGUN_API_KEY |
Yes | — | Your private Mailgun API key. |
MAILGUN_DOMAIN |
Yes | aicommander.dev |
Your verified sending domain. |
MAILGUN_REGION |
Yes | EU |
API region: EU or US. |
MAILGUN_FROM |
No | Postmaster \x3Cpostmaster@{domain}> |
Default sender address. |
Setup
npm install [email protected] [email protected]
Tools
Send Email
MAILGUN_API_KEY=xxx MAILGUN_DOMAIN=example.com MAILGUN_REGION=EU node scripts/send_email.js \x3Cto> \x3Csubject> \x3Ctext> [from]
Usage Guidance
This skill appears to do exactly what it says: it needs your Mailgun API key and domain to send email. Before installing, consider: (1) only provide a Mailgun API key you trust the skill to use—prefer a scoped/limited key if Mailgun supports it; (2) be aware the skill can send emails to arbitrary recipients while it has the key, so don't expose highly-privileged keys in shared environments; (3) npm dependencies carry normal supply-chain risk—review versions if you need stricter controls; (4) if you plan to allow autonomous invocation, limit where it can send or require explicit confirmation to avoid accidental mass sends. Rotate the API key if you later remove the skill or suspect it was exposed.
Capability Analysis
Type: OpenClaw Skill
Name: mailgun-simple
Version: 2.2.0
The OpenClaw skill 'mailgun-simple' is benign. It correctly implements an email sending utility using the official Mailgun JS SDK, reading necessary API credentials and domain information from environment variables as expected. The `SKILL.md` provides clear, non-malicious instructions and specifies legitimate dependencies. The `scripts/send_email.js` file directly passes user inputs to the Mailgun SDK without any signs of command injection vulnerabilities, data exfiltration, or other malicious activities. All observed behavior aligns with the stated purpose of sending outbound emails.
Capability Assessment
Purpose & Capability
Name/description, required env vars (MAILGUN_API_KEY, MAILGUN_DOMAIN, MAILGUN_REGION, MAILGUN_FROM), required binary (node), and npm deps (mailgun.js, form-data) all directly relate to sending Mailgun emails.
Instruction Scope
SKILL.md and scripts/send_email.js only instruct running the Node script and reading the declared environment variables; the code uses only those vars and Mailgun endpoints and does not access unrelated files, paths, or external endpoints.
Install Mechanism
Dependencies are installed via npm ([email protected] and [email protected]). This is the expected mechanism for a Node Mailgun integration; no arbitrary URL downloads or extract operations are present.
Credentials
Requested environment variables are minimal and necessary for Mailgun usage. MAILGUN_API_KEY is the primary credential; MAILGUN_FROM, DOMAIN, and REGION are appropriate and justified.
Persistence & Privilege
The skill is not always-enabled and does not request elevated platform privileges or modify other skills or system-wide settings. Default autonomous invocation is allowed (platform default) but not excessive here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mailgun-simple - After installation, invoke the skill by name or use
/mailgun-simple - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.2.0
Better startup error: missing MAILGUN_API_KEY now prints a full configuration guide with usage example and link to Mailgun dashboard
v2.1.0
Added package.json with type:module — fixes crash when running with node (ES module syntax requires explicit module type)
v2.0.2
- Updated environment variable requirements: MAILGUN_DOMAIN and MAILGUN_REGION are now required.
- Added MAILGUN_FROM to the documented required environment variables.
- Updated metadata to reflect new required variables.
- Clarified environment variable requirements in documentation table.
v2.0.1
- Added MAILGUN_DOMAIN and MAILGUN_REGION to required environment variables in metadata.
- Pinned dependencies to [email protected] and [email protected].
- Updated documentation to use a table for environment variables; added MAILGUN_FROM option.
- Clarified installation command with specific dependency versions.
v2.0.0
Resetting version history to fix inconsistencies. Final fix for security flags and metadata.
v1.0.7
- Added support for the clawdbot platform in the skill metadata.
- Removed the _meta.json file.
- No changes to core functionality or usage.
v1.0.6
- Updated SKILL.md with improved setup instructions and metadata for easier installation and configuration.
- Clarified required environment variables and added explicit install command for dependencies.
- Enhanced overall documentation clarity and formatting.
v1.0.5
- Updated documentation in SKILL.md for clarity and completeness.
- Expanded and reformatted environment variable and requirements sections.
- Added detailed setup instructions and example usage.
- Improved security notes regarding environment variables and API key handling.
v1.0.4
- No changes detected in this version.
- Documentation, environment, and installation requirements remain unchanged.
v1.0.1
- Version bump to 1.0.1 with no changes to files or documentation.
- No new features, fixes, or dependency updates in this release.
v1.2.2
Metadata Fix: Moved full metadata into SKILL.md to ensure registry correctly displays environment variables and install steps.
v1.2.1
Re-publishing for stability.
v1.2.0
Security: Removed invasive .env loading. Switched to pure process.env consumer. Metadata: Explicitly declared all required environment variables for registry visibility.
v1.1.1
Re-publishing correct version after cleanup.
v1.1.0
Security: Removed test scripts with hardcoded keys. Fixed metadata inconsistencies in the registry.
v1.0.0
Renamed to mailgun-simple. Using official mailgun.js SDK with EU region support.
Metadata
Frequently Asked Questions
What is Mailgun Simple?
Send outbound emails via the Mailgun API. Uses MAILGUN_API_KEY, MAILGUN_DOMAIN, MAILGUN_REGION, and MAILGUN_FROM. It is an AI Agent Skill for Claude Code / OpenClaw, with 756 downloads so far.
How do I install Mailgun Simple?
Run "/install mailgun-simple" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mailgun Simple free?
Yes, Mailgun Simple is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Mailgun Simple support?
Mailgun Simple is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mailgun Simple?
It is built and maintained by Coder AI (@lksrz); the current version is v2.2.0.
More Skills