# Agent Email Cli

> Operate the agent-email CLI to create disposable inboxes, poll for new mail, retrieve full message details, and manage local mailbox profiles. Use when the user needs terminal-based email inbox access for LLM or agent automation workflows.

- **Type:** Skill
- **Install:** `agentstack add skill-autohandai-community-skills-agent-email-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [autohandai](https://agentstack.voostack.com/s/autohandai)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [autohandai](https://github.com/autohandai)
- **Source:** https://github.com/autohandai/community-skills/tree/main/agent-email-cli
- **Website:** https://skilled.autohand.ai

## Install

```sh
agentstack add skill-autohandai-community-skills-agent-email-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 
```

For inbox waiting/polling:

```bash
agent-email read  --wait 30 --interval 2
```

For full message payloads:

```bash
agent-email read  --full
```

4. Retrieve one message in detail.

```bash
agent-email show  
```

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 
agent-email accounts remove 
```

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

6. Delete processed/irrelevant message when requested.

```bash
agent-email delete  
```

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

## Troubleshooting

- `command not found`: ensure `~/.bun/bin` or npm global bin path is on `PATH`.
- `NO_ACTIVE_ACCOUNT`: run `agent-email create` or `agent-email use `.
- `ACCOUNT_NOT_FOUND`: run `agent-email accounts list` and pick a valid address.
- `EOTP` during npm publish: use npm trusted publishing for CI or publish locally with OTP.

## References

- For command cheat sheet and JSON field map, read [references/commands.md](references/commands.md).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [autohandai](https://github.com/autohandai)
- **Source:** [autohandai/community-skills](https://github.com/autohandai/community-skills)
- **License:** Apache-2.0
- **Homepage:** https://skilled.autohand.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-autohandai-community-skills-agent-email-cli
- Seller: https://agentstack.voostack.com/s/autohandai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.