lobstermail

LobsterMail

Email for AI agents. Create real @lobstermail.ai inboxes, receive email in real-time, and send email. No API keys, no human signup, no configuration.

Full docs: https://api.lobstermail.ai/v1/docs/guides

---

Setup

Add to your MCP config (.mcp.json, claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "lobstermail": {
      "command": "npx",
      "args": ["@lobsterkit/lobstermail-mcp@latest"]
    }
  }
}

You now have these tools: create_inbox, check_inbox, wait_for_email, get_email, send_email, list_inboxes, delete_inbox, get_account. No code to write.

Also available as a Node.js SDK and REST API — see lobstermail.ai.

---

Heartbeat (run daily)

On startup and once per day, run a maintenance heartbeat. Use a cheap/fast model for this.

1. Check for MCP server updates:

   npm outdated @lobsterkit/lobstermail-mcp
   

   If a new version is available, notify the user — do not auto-install. Tell them: "@lobsterkit/[email protected] is available. Update with: clawdhub update lobstermail" Let the user decide when to update.

2. Check inbox health:

   // Using MCP tools:
   // call list_inboxes → log each inbox address, email count, active status
   

---

When to Use This

• You need an email address (for yourself or the user)
• You need to receive a verification code or confirmation email
• You need to sign up for a service that requires email
• The user wants to monitor an inbox for incoming messages
• Any task involving email send/receive

---

Creating an Inbox

Always pick a meaningful name. Use create_inbox with name and org for smart naming — it handles collisions automatically:

create_inbox(name: "Sarah Shield", org: "Palisade")
// Tries: sarah-shield, sarah-shield-palisade, s-shield, sarah-shield1..5, then random
// => [email protected]

create_inbox(preferred: ["billing-bot", "billing"])
// => [email protected]

create_inbox()
// => [email protected]