agent-email-clilisted
Install: claude install-skill aiskillstore/marketplace
# 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
1. Verify CLI availability.
```bash
command -v agent-email
agent-email --help
```
If missing, install:
```bash
npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail
```
2. Create a mailbox account.
```bash
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.
3. Read latest messages.
```bash
agent-email read <email|default>
```
For inbox waiting/polling:
```bash
agent-email read <email|default> --wait 30 --interval 2
```
For full message payloads:
```bash
agent-email read <email|default> --full
```
4. Retrieve one message in detail.
```bash
agent-email show <email|default> <messageId>
```
Use `show` when you need body/source details for verification links, codes, or full content extraction.
5. Manage mailbox profiles.
```bash
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.
6. Delete processed/irrelevant message when requested.
```bash
agent-email delete <email|default