Agentmail Cli

This gives Claude command-line control over AgentMail's programmable email service. You get the full suite: create inboxes on the fly, send and receive messages, manage threads and drafts, set up webhooks for incoming mail, and even configure custom domains if you've verified them. The pod system lets you group related inboxes together, which is handy for multi-agent setups. It's built for agents that need real email addresses to interact with external services or users, not just API calls pretending to be email. Requires an API key and the npm package installed globally. Output formatting is flexible with JSON, YAML, or pretty-printed options.

skills.sh installs: 1.7K
GitHub stars: 26
last updated: Aug 21, 2026

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

AgentMail CLI

Install the CLI and provide the API key through the environment.

npm install -g agentmail-cli
export AGENTMAIL_API_KEY="am_..."

A resource nested under another is a nested subcommand, e.g. inboxes messages, inboxes threads, pods inboxes, pods threads (CLI 1.x; the colon form inboxes:messages is rejected). Run agentmail <resource> --help to list what a resource supports.

Inboxes

agentmail inboxes list
agentmail inboxes get --inbox-id <inbox_id>
agentmail inboxes create --display-name "Support Agent" --username support
agentmail inboxes delete --inbox-id <inbox_id>

Confirm the exact inbox before running the destructive delete command.

Messages and threads

agentmail inboxes messages list --inbox-id <inbox_id>
agentmail inboxes messages get --inbox-id <inbox_id> --message-id <message_id>

agentmail inboxes messages send --inbox-id <inbox_id> \
  --to "recipient@example.com" \
  --subject "Hello" \
  --text "Message body"

# HTML body instead of plain text
agentmail inboxes messages send --inbox-id <inbox_id> \
  --to "recipient@example.com" \
  --subject "Hello" \
  --html "<h1>Hello</h1>"

SKILL.md on GitHub