A powerful CLI tool for managing AI agent email communications, including inbox creation and full thread management via the AgentMail API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agentmail-mcp-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install agentmail-mcp-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AgentMail MCP CLI?
The AgentMail MCP CLI is a specialized tool designed to give AI agents the ability to interact with the world through email. By leveraging the AgentMail API, this skill allows for the programmatic creation of inboxes, sending and receiving of messages, and complex thread management. It is a vital component for developers building autonomous agents that need a professional communication channel. This integration within the Openclaw Skills ecosystem ensures that your agents can handle customer support, outreach, and internal notifications with ease through a standardized interface.
AgentMail MCP CLI Use Cases
- Automating customer support replies for AI-driven helpdesks.
- Creating unique email inboxes for temporary AI agents or specific marketing campaigns.
- Filtering and archiving incoming emails based on custom labels.
- Forwarding urgent communications from agents to human supervisors.
- Managing large-scale outbound email sequences with programmatic control.
How AgentMail MCP CLI Works
- Install the CLI tool globally using Node.js to enable the agentmail command.
- Authenticate the session by providing a valid AgentMail API key via environment variables.
- Use the CLI to create and configure dedicated inboxes for your AI agents.
- Programmatically fetch, filter, or send emails using structured commands.
- Organize communications using labels and thread management to maintain a clean workspace.
AgentMail MCP CLI Setup
To get started with this skill, ensure you have Node.js (>= 20.0.0) installed on your system.
npm install -g openclaw-agentmail-cli
Next, set your API key as an environment variable to authenticate with the AgentMail service:
export AGENTMAIL_API_KEY="your_api_key_here"
Verify the installation by listing your current inboxes:
agentmail inboxes list
AgentMail MCP CLI Data Schema & Taxonomy
The skill interacts with several core entities via the AgentMail API to organize communication data efficiently:
| Entity | Description | Key Attributes |
|---|---|---|
| Inbox | The primary email container | id, username, domain, display_name |
| Thread | A collection of related messages | id, inbox_id, labels, last_updated |
| Message | An individual email within a thread | id, to, subject, text, html, labels |
| Attachment | Files associated with messages | id, thread_id, download_url |
AgentMail MCP CLI Advanced Features
- Multi-recipient support for CC and BCC fields in outgoing mail.
- Advanced filtering using ISO 8601 timestamps (before/after) and JSON labels.
- Full HTML email support for sending rich-text communication.
- Simultaneous label addition and removal for complex workflow state management.
- Compatibility with MCPorter for standardized AI agent calls within Openclaw Skills.
- Detailed thread retrieval including all message history in a single command call.
SKILL.md
Loading
Related Openclaw Skills
TickTick CLI
A professional-grade terminal interface for managing TickTick tasks, projects, and habits with deterministic JSON output.
MTV Rewind
A nostalgic music video streaming skill that brings 90,000+ classic MTV visuals from the 80s, 90s, and 2000s directly to your AI agent.
Web Search Skill
A comprehensive web search and content extraction skill that enables AI agents to retrieve real-time data using Jina AI and DuckDuckGo without mandatory API keys.
Cocktail Boy
A private AI mixologist skill for Openclaw that provides access to over 1,635 cocktail recipes and preparation guides.
IBKR Trading Automation
An automated trading skill for Interactive Brokers that simplifies authentication and API interaction via the Client Portal Gateway.
Bitpanda Portfolio Skill
A command-line interface tool to monitor Bitpanda balances and transaction history.
Featured*
