How do I install the Agentmail CLI skill?

Run npx skillmds@latest add lord1egypt/agentmail-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agentmail CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agentmail CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agentmail CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agentmail CLI?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agentmail CLI by lord1egypt — Agent Skill

Name: Agentmail CLI
Rating: 4.2 (5 reviews)
Author: Lord1Egypt

File contents

AgentMail CLI

Use the agentmail CLI to send and receive emails programmatically. Requires AGENTMAIL_API_KEY environment variable.

Install

npm install -g agentmail-cli

Core Commands

Inboxes

# Create an inbox (defaults to @agentmail.to;
# pass --domain only if you have verified a custom domain)
agentmail inboxes create --display-name "My Agent" --username myagent

# List inboxes
agentmail inboxes list

# Get an inbox
agentmail inboxes retrieve --inbox-id <inbox_id>

# Delete an inbox
agentmail inboxes delete --inbox-id <inbox_id>

Send Email

# Send a message from an inbox
agentmail inboxes:messages send --inbox-id <inbox_id> \
  --to "recipient@example.com" \
  --subject "Hello" \
  --text "Message body"

# Send with HTML
agentmail inboxes:messages send --inbox-id <inbox_id> \
  --to "recipient@example.com" \
  --subject "Hello" \
  --html "<h1>Hello</h1>"

# Reply to a message
agentmail inboxes:messages reply --inbox-id <inbox_id> --message-id <message_id> \
  --text "Reply body"

# Forward a message
agentmail inboxes:messages forward --inbox-id <inbox_id> --message-id <message_id> \
  --to "someone@example.com"

Read Email

# List messages in an inbox
agentmail inboxes:messages list --inbox-id <inbox_id>

# Get a specific message
agentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id <message_id>

# List threads
agentmail inboxes:threads list --inbox-id <inbox_id>

# Get a thread
agentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id <thread_id>

Drafts

# Create a draft
agentmail inboxes:drafts create --inbox-id <inbox_id> \
  --to "recipient@example.com" \
  --subject "Draft" \
  --text "Draft body"

# Send a draft
agentmail inboxes:drafts send --inbox-id <inbox_id> --draft-id <draft_id>

Pods

Pods group inboxes together.

# Create a pod
agentmail pods create --name "My Pod"

# Create an inbox in a pod
agentmail pods:inboxes create --pod-id <pod_id> --display-name "Pod Inbox"

# List threads in a pod
agentmail pods:threads list --pod-id <pod_id>

Webhooks

# Create a webhook for new messages
agentmail webhooks create --url "https://example.com/webhook" --event-type message.received

# List webhooks
agentmail webhooks list

Domains

# Add a custom domain. --feedback-enabled is REQUIRED:
# pass the flag to route bounce/complaint notifications to your inboxes.
# The CLI has no way to create a domain without this flag.
agentmail domains create --domain example.com --feedback-enabled

# Verify domain DNS
agentmail domains verify --domain-id <domain_id>

# Get DNS records to configure
agentmail domains get-zone-file --domain-id <domain_id>

Global Flags

All commands support: --api-key, --base-url, --environment, --format, --format-error, --transform, --transform-error, --debug.

Output Formats

Use --format to control output: auto (default), pretty, json, jsonl, yaml, raw, explore.

---name: agentmail-clidescription: Send and receive emails programmatically using the AgentMail CLI. Use when agents need to manage inboxes, send/receive emails, handle threads, drafts, webhooks, and domains via command line.---# AgentMail CLIUse the `agentmail` CLI to send and receive emails programmatically. Requires `AGENTMAIL_API_KEY` environment variable.## Install```bashnpm install -g agentmail-cli```## Core Commands### Inboxes```bash# Create an inbox (defaults to @agentmail.to;# pass --domain only if you have verified a custom domain)agentmail inboxes create --display-name "My Agent" --username myagent# List inboxesagentmail inboxes list# Get an inboxagentmail inboxes retrieve --inbox-id <inbox_id># Delete an inboxagentmail inboxes delete --inbox-id <inbox_id>```### Send Email```bash# Send a message from an inboxagentmail inboxes:messages send --inbox-id <inbox_id> \ --to "recipient@example.com" \ --subject "Hello" \ --text "Message body"# Send with HTMLagentmail inboxes:messages send --inbox-id <inbox_id> \ --to "recipient@example.com" \ --subject "Hello" \ --html "<h1>Hello</h1>"# Reply to a messageagentmail inboxes:messages reply --inbox-id <inbox_id> --message-id <message_id> \ --text "Reply body"# Forward a messageagentmail inboxes:messages forward --inbox-id <inbox_id> --message-id <message_id> \ --to "someone@example.com"```### Read Email```bash# List messages in an inboxagentmail inboxes:messages list --inbox-id <inbox_id># Get a specific messageagentmail inboxes:messages retrieve --inbox-id <inbox_id> --message-id <message_id># List threadsagentmail inboxes:threads list --inbox-id <inbox_id># Get a threadagentmail inboxes:threads retrieve --inbox-id <inbox_id> --thread-id <thread_id>```### Drafts```bash# Create a draftagentmail inboxes:drafts create --inbox-id <inbox_id> \ --to "recipient@example.com" \ --subject "Draft" \ --text "Draft body"# Send a draftagentmail inboxes:drafts send --inbox-id <inbox_id> --draft-id <draft_id>```### PodsPods group inboxes together.```bash# Create a podagentmail pods create --name "My Pod"# Create an inbox in a podagentmail pods:inboxes create --pod-id <pod_id> --display-name "Pod Inbox"# List threads in a podagentmail pods:threads list --pod-id <pod_id>```### Webhooks```bash# Create a webhook for new messagesagentmail webhooks create --url "https://example.com/webhook" --event-type message.received# List webhooksagentmail webhooks list```### Domains```bash# Add a custom domain. --feedback-enabled is REQUIRED:# pass the flag to route bounce/complaint notifications to your inboxes.# The CLI has no way to create a domain without this flag.agentmail domains create --domain example.com --feedback-enabled# Verify domain DNSagentmail domains verify --domain-id <domain_id># Get DNS records to configureagentmail domains get-zone-file --domain-id <domain_id>```## Global FlagsAll commands support: `--api-key`, `--base-url`, `--environment`, `--format`, `--format-error`, `--transform`, `--transform-error`, `--debug`.## Output FormatsUse `--format` to control output: `auto` (default), `pretty`, `json`, `jsonl`, `yaml`, `raw`, `explore`.

Frequently asked questions

Agentmail CLI