What is agent-email-cli?

A command-line tool for giving an AI agent disposable email inboxes. It can create mailboxes, wait for incoming messages, read full messages, and manage local mailbox profiles.

Use it to create a test inbox, poll for new mail, search or read messages, and retrieve one message's full contents for extracting codes, links, or other details.

It provides temporary email access for workflows that need to receive verification links, login codes, or other automated messages without relying on a personal inbox.

agent-email-cli — Skill for Claude Code and Codex by autohandai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add autohandai/community-skills --skill agent-email-cli

Clone the repo

git clone --depth 1 https://github.com/autohandai/community-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/autohandai/community-skills/agent-email-cli/github.svg)](https://agentmods.dev/skills/autohandai/community-skills/agent-email-cli)

Your own site

<a href="https://agentmods.dev/skills/autohandai/community-skills/agent-email-cli"><img src="https://agentmods.dev/badge/skills/autohandai/community-skills/agent-email-cli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/autohandai/community-skills/agent-email-cli"><img src="https://agentmods.dev/badge/skills/autohandai/community-skills/agent-email-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 653 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00049	$0.00653
Opus 5	$0.00024	$0.00327
Sonnet 5	$0.00010	$0.00131
Haiku 4.5	$0.00005	$0.00065

Measured 9d ago against content hash ccefa3620ef4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

agent-email-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agent-email-cli/SKILL.md · 106 lines

How it starts

The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

Manage mailbox profiles.

agent-email accounts list
agent-email use <email|default>
agent-email accounts remove <email>

Avoid commands that require entering secrets on the command line in agent logs.

Delete processed/irrelevant message when requested.

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

Operational Guidance

Keep command output machine-readable; avoid forcing human output unless requested.
Prefer default alias when user does not specify an email.
Never echo, store, or summarize secret values (password, token) from command output.
If command fails, surface the JSON error code and hint fields directly.
For auth failures (AUTH_REQUIRED/401), rerun command once and request user intervention if credentials must be re-established.
For rate limits (RATE_LIMITED/429), retry after short delay.

Read the full file on GitHub · 106 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

9d ago First seen · 106 lines · 49 tokens per session scan A ccefa3620ef4

Subscribe to this mod's changes

agent-email-cli is a skill published in the GitHub repository autohandai/community-skills (11 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 49 tokens to every session and 653 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Productivity agent-skill agent-skills agentsmd coding-agent-skills skillsmd

template-library

A personal library for saving, reusing, listing, editing, and versioning content templates. Templates can include replaceable fields such as a title, problem, solution, or call to action.

ZJU-REAL/Easel · 144 tokens

skill-my-account

A read-only account lookup workflow for checking the user’s own logged-in Xiaohongshu, Douyin, Kuaishou, Zhihu, or WeChat Channels accounts. It can show account identity and available creator statistics such as followers, likes, following, works, and post lists.

ZJU-REAL/Easel · 117 tokens

agent-email-cli