Integrations

LobsterMail works wherever your AI agent runs. Connect via MCP for zero-code tool access, install from Openclaw with one click, 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.

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.