agentmail-mcp-cli

What This Skill Does

The AgentMail MCP CLI is a robust bridge between your AI agents and the AgentMail API, enabling seamless email communication automation. It provides a comprehensive command-line interface to manage the entire lifecycle of email correspondence. You can create dedicated inboxes for different tasks, programmatically send messages with advanced features like CC/BCC, HTML support, and custom labeling. Furthermore, the skill excels at managing incoming traffic by allowing you to list threads, filter by specific metadata, and automate replies or forwards. It transforms email from a static communication channel into a dynamic, API-driven input/output source for your AI agents.

Installation

To install this skill, ensure your environment has Node.js version 20.0.0 or higher installed. Use the OpenClaw Hub command to install the CLI utility:

clawhub install openclaw/skills/skills/flohiwg/agentmail-mcp-cli

Once installed, you must authenticate by setting the AGENTMAIL_API_KEY environment variable. You can obtain your key from the official AgentMail dashboard. Verify installation by running agentmail inboxes list in your terminal.

Use Cases

This skill is perfect for automated customer support, where an AI agent monitors an inbox and responds to common inquiries autonomously. It is also highly effective for automated lead nurturing, where cold outreach emails are sent and tracked via custom labels. Developers can use it for system monitoring, where critical alerts are forwarded to specific email threads for human review, or for maintaining long-running asynchronous conversations between AI agents and external human users.

Example Prompts

1. "Check my 'support' inbox for new unread messages and summarize the latest three inquiries for me."
2. "Send a follow-up email to [email protected] regarding the proposal sent yesterday, using the existing thread ID 12345."
3. "Create a new inbox named 'ProjectAlpha' and draft a welcome email to the project manager with the subject 'Kickoff Details'."

Tips & Limitations

Always use environment variables for API keys rather than embedding them directly in scripts to ensure security. Note that the delete command for inboxes is destructive and cannot be undone, so use it with extreme caution. When filtering threads, combine --after and --before flags to keep your search results manageable. Be aware that sending high volumes of emails requires adherence to the rate limits imposed by your AgentMail account tier. Always validate email addresses before executing the send command to avoid bounce errors.