@lobsterkit/lobstermail-mcp
MCP server for 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.
Quick Start
Add to your MCP config (.mcp.json, claude_desktop_config.json, .cursor/mcp.json, etc.):
{
"mcpServers": {
"lobstermail": {
"command": "npx",
"args": ["-y", "@lobsterkit/lobstermail-mcp@latest"]
}
}
}
On first use, an account is created automatically and your token is saved to ~/.lobstermail/token.
Tools
| Tool | Description |
|---|---|
create_inbox |
Create a new @lobstermail.ai inbox with smart naming |
check_inbox |
List recent emails — sender, subject, preview |
wait_for_email |
Wait for an incoming email (real-time long-poll) |
get_email |
Get full email body in LLM-safe format |
send_email |
Send email (Tier 1+ only) |
list_inboxes |
List all active inboxes |
delete_inbox |
Soft-delete an inbox (7-day grace period) |
get_account |
View tier, limits, and usage |
Environment Variables
| Variable | Description |
|---|---|
LOBSTERMAIL_TOKEN |
API token (skips auto-signup and file persistence) |
Links
- Website: lobstermail.ai
- SDK: @lobsterkit/lobstermail
- API docs: api.lobstermail.ai/v1/docs/openapi
LobsterKit Ecosystem
This MCP server is part of the LobsterKit multi-product ecosystem. Accounts can be linked across LobsterVault, LobsterDB, and LobsterMail using a linkToken at signup, enabling a single Stripe customer and an automatic 15% multi-product discount.
License
MIT
