mcpField
A
agent-email-cli

agent-email-cli

github.com/zaddy6Productivity62.1k installsUpdated 35w ago
Repository

About agent-email-cli

agent-email-cli is a skill for using the `agent-email` CLI in agent workflows that need inbox access. It covers mailbox setup, message retrieval and deletion, while emphasizing machine-readable output and secret handling.

Key features

  1. 01Create and switch mailbox accounts
  2. 02Read, wait for, and inspect messages
  3. 03Delete processed messages
  4. 04Keep output machine-readable
  5. 05Avoid exposing passwords and tokens

Use cases

  1. 01Create a mailbox for an agent workflow
  2. 02Poll for incoming verification messages
  3. 03Inspect message contents or source
  4. 04Remove processed or irrelevant mail

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/zaddy6/agent-email-skill --skill agent-email-cli

After installing, type/agent-email-cliin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/commands.md

Details

From the project README

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.
command -v agent-email
agent-email --help

If missing, install:

npm install -g @zaddy6/agentemail
# or
bun install -g @zaddy6/agentemail
  1. 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.

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

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

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

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 <email>.
  • 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

Comments

Markdown supported