Agent Email Cli

If you're building agents that need to verify signups, catch confirmation emails, or test workflows end-to-end without polluting a real inbox, this gives Claude direct terminal access to disposable email addresses. It wraps the agent-email CLI with sensible defaults: JSON output by default, polling support for waiting on messages, and profile management so you can juggle multiple throwaway inboxes. The skill is careful about secrets, it won't echo passwords or tokens back into logs. Most useful when you're automating something that sends you a link or code and you need the agent to go grab it without manual intervention.

skills.sh installs: 2.1K
GitHub stars: 6
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add zaddy6/agent-email-skill --skill agent-email-cli --agent claude-code

Installs into .claude/skills of the current project.

Files

Agent Email CLI

Overview

Use this skill to operate the agent-email command safely and predictably for agent workflows that need inbox access.

Prefer JSON-native command output and return key fields (email, messageId, subject, createdAt, from.address) in your summaries.

Workflow

Verify CLI availability.

command -v agent-email
agent-email --help

If missing, install:

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail

Create a mailbox account.

agent-email create

Record these fields from JSON output:

data.email
data.accountId
data.activeEmail

Do not record, repeat, or print secret values such as mailbox passwords or tokens.

Read latest messages.

agent-email read <email|default>

For inbox waiting/polling:

agent-email read <email|default> --wait 30 --interval 2

For full message payloads:

agent-email read <email|default> --full

Retrieve one message in detail.

agent-email show <email|default> <messageId>

Use show when you need body/source details for verification links, codes, or full content extraction.

SKILL.md on GitHub

Details

Repository: github.com/zaddy6/agent-email-skill
Categories: AI & Agent Building, CLI & Terminal