Skills

Getting started

AgentMail provides an official skill that can be installed on AI coding assistants and agents that support the AgentSkills format. This includes OpenClaw, Claude Code, Cursor, Codex, and other compatible tools.

The skill is available at skills.sh/agentmail-to/agentmail-skills/agentmail.

Installation

Install the skill using the skills CLI. This works with Claude Code, Cursor, OpenClaw, Codex, and other compatible agents:

$
npx skills add agentmail-to/agentmail-skills

To skip interactive prompts, specify the skill and agent directly:

$
npx skills add agentmail-to/agentmail-skills --skill agentmail --agent claude-code

OpenClaw via ClawHub

OpenClaw users can also install via ClawHub:

$
npx clawhub@latest install agentmail

Manual installation

You can also manually clone the skill repository:

$
git clone https://github.com/agentmail-to/agentmail-skills.git ~/.skills/agentmail

Configuration

After installation, configure your AgentMail API key. The method varies by platform:

Environment variable

Set the AGENTMAIL_API_KEY environment variable:

$
export AGENTMAIL_API_KEY="your-api-key-here"

OpenClaw configuration

Add the API key to ~/.openclaw/openclaw.json:

1
{
2
  "skills": {
3
    "entries": {
4
      "agentmail": {
5
        "enabled": true,
6
        "env": {
7
          "AGENTMAIL_API_KEY": "your-api-key-here"
8
        }
9
      }
10
    }
11
  }
12
}

Get your API key from the AgentMail Console.

Features

The official AgentMail skill provides comprehensive email functionality:

Inboxes

Create scalable inboxes on-demand. Each inbox has a unique email address that your AI agent can use to send and receive emails.

Messages

Send emails with both plain text and HTML content for best deliverability. The skill handles proper formatting and headers automatically.

Threads

Threads group related messages in a conversation, making it easy to follow email chains and maintain context across multiple exchanges.

Attachments

Send and receive attachments with Base64 encoding. The skill can retrieve attachments from messages or threads.

Drafts

Create drafts for human-in-the-loop approval before sending. This is useful when you want to review emails before they go out.

Pods

Multi-tenant isolation for SaaS platforms. Each customer gets isolated inboxes, perfect for building email-enabled applications.

Idempotency

Use idempotency keys for safe retries on create operations. This prevents duplicate emails when network errors occur.

Real-time events

The skill supports both WebSockets (persistent connection, no public URL needed) and webhooks (HTTP-based notifications) for real-time email notifications.

Example usage

Once installed, you can ask your AI assistant to perform email tasks:

• “Create a new email inbox for my project”
• “Send an email to john@example.com about the meeting tomorrow”
• “Check my inbox for new emails”
• “Reply to the latest email from Sarah”
• “Create a draft response to the support ticket”

Resources

• Official AgentMail Skill on skills.sh
• AgentMail Skills Repository
• AgentMail API Reference
• AgentMail Console