OpenParable
Skip to content
← Back to skills

Moemail

Apps & Automation
moemail

Moemail is an Agent Skill for apps & automation published in the beilunyang/moemail repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when an AI agent needs a temporary/disposable email address — for receiving verification emails, testing email integrations, or any task requiring a temporary inbox via the moemail CLI

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/beilunyang/moemail/blob/HEAD/packages/cli/skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/moemail, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

MoeMail — Temporary Email for AI Agents

Overview

MoeMail provides disposable email addresses with an agent-first CLI (moemail). Create inboxes, wait for messages, read content, and send emails programmatically.

Install

Install the MoeMail CLI globally when it is not already available:

npm i -g @moemail/cli

Then confirm the binary is available:

moemail --help

Setup

Configure once per environment:

moemail config set api-url https://moemail.app
moemail config set api-key YOUR_API_KEY

Or via environment variables: MOEMAIL_API_URL, MOEMAIL_API_KEY.

Core Workflow: Receive an Email

# 1. Create inbox — capture ONCE, parse both fields
RESULT=$(moemail --json create --expiry 1h)
ID=$(echo "$RESULT" | jq -r '.id')
EMAIL=$(echo "$RESULT" | jq -r '.address')

# 2. Use $EMAIL wherever needed (registration, forms, etc.)

# 3. Wait for message (exits when message arrives or times out)
MSG=$(moemail --json wait --email-id "$ID" --timeout 120)
MSG_ID=$(echo "$MSG" | jq -r '.messageId')

# 4. Read full message content
moemail --json read --email-id "$ID" --message-id "$MSG_ID"

Command Reference

CommandRequired OptionsNotable Options
config set<key> <value>keys: api-url, api-key
create—--name, --domain, --expiry (1h|24h|3d|permanent)
list—--email-id (lists messages in mailbox), --cursor
wait--email-id--timeout (default 120s), --interval (default 5s)
read--email-id, --message-id--format (text|html)
send--email-id, --to, --subject, --content—
delete--email-id—

--json is a global flag — it works before or after the subcommand:

moemail --json create --expiry 24h   # both work
moemail create --expiry 24h --json

JSON Output Shapes

create: { "id": "...", "address": "[email protected]", "expiresAt": "2025-..." }

wait: { "messageId": "...", "from": "...", "subject": "...", "receivedAt": "2025-..." }

read: { "id": "...", "from": "...", "to": "...", "subject": "...", "content": "plain text", "html": "...", "receivedAt": "..." }

send: { "success": true, "remainingEmails": 10 }

Common Mistakes

MistakeFix
Calling create twice to get id + addressCall once, save to variable, parse both fields
Timeout too short for slow servicesUse --timeout 300 for unreliable senders
Inbox expired mid-testUse --expiry permanent for long-running workflows
Using content field for HTML emailsCheck both content (plain text) and html fields