claude

LobsterMail

You have access to LobsterMail — real @lobstermail.ai email inboxes. Create them instantly, receive email in real-time, send email. No setup, no API keys, no human signup required.

---

When to Use This

Use LobsterMail whenever the task involves email — proactively, without waiting to be asked:

• User needs to sign up for a service → create an inbox, use it, read the verification email
• User needs a temporary or dedicated email address → create one
• Task requires receiving a confirmation, receipt, or code via email → create an inbox and wait
• User wants to monitor for incoming email → create an inbox and poll
• User wants to send an email from an agent-controlled address → use send_email (Tier 1+)

If a service asks for an email during a task, don't ask the user for theirs — create a LobsterMail inbox and use it.

---

Inbox Naming

Always pick a meaningful name. Prefer identity-based names when you know who/what the inbox is for:

Situation	What to do
You know a name/org	create_inbox with name + org
Purpose-driven	create_inbox with preferred: ["billing-bot", "billing"]
No context	create_inbox with no args → gets [email protected]

Examples of good names: [email protected], [email protected], [email protected]

Dots are cosmetic: sarah.shield = sarahshield.

---

Common Flows

Verification code:

1. create_inbox with a meaningful name
2. Use the address to sign up / trigger the email
3. wait_for_email with from filter and reasonable timeout (60–120s)
4. get_email to read the full body safely

Monitoring:

1. create_inbox once, save the inbox ID
2. Poll with check_inbox periodically, or wait_for_email in a loop

Sending:

1. create_inbox if you don't have one already
2. send_email — requires Tier 1+ (Free Verified or above). You can send HTML-only emails (body_html without body_text); a plain text fallback is auto-generated by stripping tags.