← Back to Skills Marketplace
adboio

AgentMail

by adboio · GitHub ↗ · v1.1.1
cross-platform ✓ Security Clean
36116
Downloads
63
Stars
350
Active Installs
3
Versions
Install in OpenClaw
/install agentmail
Description
API-first email platform designed for AI agents. Create and manage dedicated email inboxes, send and receive emails programmatically, and handle email-based workflows with webhooks and real-time events. Use when you need to set up agent email identity, send emails from agents, handle incoming email workflows, or replace traditional email providers like Gmail with agent-friendly infrastructure.
Usage Guidance
Install only if you intend to give an agent an email identity. Keep AGENTMAIL_API_KEY secure, verify recipients and attachments before sending, restrict webhook endpoints, avoid logging full payloads in shared environments, and redact or summarize email content before forwarding it to systems like GitHub or Slack.
Capability Analysis
Type: OpenClaw Skill Name: agentmail Version: 1.1.1 This skill bundle is designed for an AI agent to interact with the AgentMail API for email management. All provided scripts (`check_inbox.py`, `send_email.py`, `setup_webhook.py`) and documentation (`API.md`, `WEBHOOKS.md`, `EXAMPLES.md`) are clearly aligned with this stated purpose. Critically, the `SKILL.md` file explicitly warns about prompt injection risks from incoming emails and provides detailed defensive measures (webhook allowlisting, isolated sessions) for the agent to implement, demonstrating a strong security-conscious design rather than malicious intent. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. The local test server in `setup_webhook.py` is clearly for development and does not pose a threat.
Capability Assessment
Purpose & Capability
The documented purpose matches the artifacts: creating inboxes, reading messages, sending email, handling attachments, and configuring webhooks are all expected for an email API skill.
Instruction Scope
The prompt-injection phrase appears as a defensive warning about hostile inbound email, followed by allowlist and isolated-review guidance rather than as an instruction to obey.
Install Mechanism
The skill asks users to install third-party Python packages with pip; this is normal for the integration but should be done from trusted package sources.
Credentials
The scripts use AGENTMAIL_API_KEY and can read user-selected attachment files for sending. The credential need is documented in the skill, though registry metadata does not appear to declare it separately.
Persistence & Privilege
Webhook creation and inbox monitoring can create persistent email workflows, but they are user-invoked, disclosed, and aligned with the stated purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install agentmail
  3. After installation, invoke the skill by name or use /agentmail
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
🔒 Security: Webhook allowlist to prevent prompt injection
v1.1.0
🔒 CRITICAL SECURITY: Added webhook allowlist implementation to prevent prompt injection attacks. Email webhooks now require sender filtering to protect against malicious instructions.
v1.0.0
Initial release: API-first email for AI agents. Includes send/receive scripts, webhook setup, and comprehensive documentation.
Metadata
Slug agentmail
Version 1.1.1
License
All-time Installs 354
Active Installs 350
Total Versions 3
Frequently Asked Questions

What is AgentMail?

API-first email platform designed for AI agents. Create and manage dedicated email inboxes, send and receive emails programmatically, and handle email-based workflows with webhooks and real-time events. Use when you need to set up agent email identity, send emails from agents, handle incoming email workflows, or replace traditional email providers like Gmail with agent-friendly infrastructure. It is an AI Agent Skill for Claude Code / OpenClaw, with 36116 downloads so far.

How do I install AgentMail?

Run "/install agentmail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AgentMail free?

Yes, AgentMail is completely free (open-source). You can download, install and use it at no cost.

Which platforms does AgentMail support?

AgentMail is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AgentMail?

It is built and maintained by adboio (@adboio); the current version is v1.1.1.

💬 Comments