How do I install the Agentmail CLI skill?

Run npx skillmds@latest add lev-os/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. 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?

lev-os (@lev-os) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agentmail CLI by lev-os — Agent Skill

Name: Agentmail CLI
Rating: 4.2 (5 reviews)
Author: lev-os

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
agentmail inboxes create --display-name "My Agent" --username myagent --domain example.com

# 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
agentmail domains create --domain example.com --feedback-enabled false

# 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, --debug.

Output Formats

Use --format to control output: json (default), pretty, yaml, jsonl, 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 inboxagentmail inboxes create --display-name "My Agent" --username myagent --domain example.com# 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 domainagentmail domains create --domain example.com --feedback-enabled false# 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`, `--debug`.## Output FormatsUse `--format` to control output: `json` (default), `pretty`, `yaml`, `jsonl`, `raw`, `explore`.

Frequently asked questions

Agentmail CLI