Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOBSTERMAIL_TOKEN | No | API token (skips auto-signup and file persistence) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_inbox | Create a new email inbox. Returns an @lobstermail.ai address. Provide your name/org for a meaningful address (e.g. sarah-shield@lobstermail.ai), or omit for a random lobster-xxxx address. |
| check_inbox | List recent emails in an inbox. Returns sender, subject, and preview for each email. |
| wait_for_email | Wait for an incoming email matching optional filters. Returns near-instantly when an email arrives (real-time server-side long-polling). Returns the email body in LLM-safe format. |
| get_email | Get a single email by ID with full body in LLM-safe format. |
| send_email | Send an email from an inbox. Requires a verified account (Tier 1+). To reply within a thread, provide in_reply_to with the Message-ID of the email being replied to. |
| search_emails | Search emails across all inboxes by keyword. Matches against subject, sender address, and body preview. Optionally scope to a single inbox or filter by sender, direction, date, or attachments. |
| list_threads | List conversation threads for an inbox. Threads group related emails by In-Reply-To/References headers or subject matching. Returns newest threads first. |
| get_thread | Get a conversation thread with all its emails in chronological order. Shows the full conversation flow including sender, subject, and preview for each email. |
| list_inboxes | List all active inboxes for this account. |
| delete_inbox | Soft-delete an inbox. It enters a 7-day grace period before permanent deletion. |
| get_account | Get account information including tier, limits, and usage stats. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |