Integrations

LobsterMail works wherever your AI agent runs. Connect via MCP for zero-code tool access, use LobsterMail as a native piece in workflow platforms, import the Node.js SDK, or call the REST API from any language. Pick the method that fits your stack.

AI Coding Tools (MCP)#

The Model Context Protocol gives AI agents email tools — create_inbox, wait_for_email, send_email, and more — without writing any code. The MCP server handles auto-signup and token persistence automatically.

Claude Code#

Add to your project .mcp.json or global ~/.claude.json:

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

Claude Desktop#

Add to your claude_desktop_config.json:

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

Or install with a single command:

curl -sL https://lobstermail.ai/install | sh

Cursor#

Add to .cursor/mcp.json in your project root:

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

Any MCP-Compatible Client#

LobsterMail works with any client that supports the Model Context Protocol. Run the MCP server with:

npx @lobsterkit/lobstermail-mcp@latest

Point your MCP client at the server using stdio transport. See the MCP Server guide for the full tool reference, security model, and token sharing details.

Openclaw & Skill Marketplaces#

LobsterMail publishes skill metadata to Openclaw and ClawHub, the open registry for MCP-compatible agent skills. Any platform that reads Openclaw skills can discover and install LobsterMail automatically.

ClawHub (One-Click Install)#

Install or update the MCP server from your terminal:

clawdhub update lobstermail

The skill definition is also available as raw Markdown at https://api.lobstermail.ai/skill — useful for agents that consume skill metadata directly.

Compatible Platforms#

LobsterMail's MCP server runs on any platform that supports the Openclaw skill format or the MCP protocol, including:

• ZeroClaw — Lightweight, Rust-based agent runtime. Integrates MCP servers at startup and exposes tools natively to the agent loop.
• NanoClaw — Containerized agent platform running inside Docker. Built on Anthropic's Agent SDK with full MCP support.
• NemoClaw (NVIDIA) — Enterprise-grade platform built on the Openclaw framework. Adds privacy and security controls with NVIDIA Agent Toolkit and supports local Nemotron models.
• Moltis — Local-first AI gateway written in Rust. Native MCP support with health polling and automatic crash recovery.

Workflow & Agent Platforms#

LobsterMail is available as a native integration on popular workflow automation and AI agent platforms. These integrations let you use LobsterMail actions (create inbox, send email, list emails, search, etc.) as drag-and-drop steps in your workflows.

ActivePieces#

LobsterMail is a community piece in ActivePieces. Use it to add email actions and triggers to any workflow — create inboxes, send emails, poll for new messages, and search across inboxes.

Install the LobsterMail piece from the ActivePieces piece library. Requires a LobsterMail API key for authentication.

Composio#

Use LobsterMail as a toolkit in Composio to give any AI agent email capabilities. The integration provides 9 tools: create inbox, list inboxes, send email, list emails, get email, search emails, list threads, create webhook, and get account info.

Available as a custom tool example — see the Composio PR for setup instructions.

Langflow#

LobsterMail is available as a component in Langflow, the visual framework for building AI workflows. Supports 7 operations: create inbox, list inboxes, send email, list emails, get email, search emails, and get account info.

See the Langflow PR for the latest status.

Glama.ai#

LobsterMail's MCP server is listed on Glama.ai, the MCP server directory. Discover and connect the server directly from the Glama marketplace.

Node.js SDK#

Install the SDK and start using LobsterMail in your TypeScript or JavaScript project:

npm install @lobsterkit/lobstermail

import { LobsterMail } from '@lobsterkit/lobstermail';

const lm = await LobsterMail.create();
const inbox = await lm.createSmartInbox({ name: 'My Agent' });
const emails = await inbox.receive();

The SDK handles auto-signup, token persistence, smart inbox naming, and prompt injection protection out of the box. See the Getting Started guide for a full walkthrough.

REST API#

Use the REST API from any language or platform. LobsterMail provides a full OpenAPI 3.1 specification — generate a client in Python, Go, Ruby, Java, or any language with OpenAPI tooling.

Base URL: https://api.lobstermail.ai/v1

# Sign up (no email or identity required)
curl -s -X POST https://api.lobstermail.ai/v1/signup | jq

# Create an inbox
curl -s -X POST https://api.lobstermail.ai/v1/inboxes \
  -H "Authorization: Bearer lm_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}' | jq

All endpoints use Bearer token authentication. Tokens are issued at signup and follow the format lm_sk_live_*. See the API reference for the complete endpoint list.