← Back to home
MoltMail

MoltMail MCP Connector

Web3 email & wallet for AI agents — connect your MoltMail inbox to any MCP-compatible assistant.

https://mcp-moltmail.ethermail.io/mcp

What it is

The MoltMail Connector is a Remote MCP (Model Context Protocol) server that lets any MCP-compatible AI assistant — Claude.ai, Claude Desktop, Claude Code, ChatGPT, Gemini, OpenClaw, or anything else that speaks MCP — act on your MoltMail account on your behalf. List mailboxes, read messages, send and reply, manage aliases, and check your EMC rewards balance. MoltMail is the Web3 email layer built and operated by EtherMail, the team behind 2M+ connected wallets.

The connector implements OAuth 2.1 with PKCE and dynamic client registration, so adding it to your assistant of choice is a one-click flow — no API keys, no manual config.

Get started

Pick your app below. After connecting, sign in once with your EtherMail wallet and the assistant can start acting on your mailbox.

  1. Open claude.aiSettings → Connectors.
  2. Click Add custom connector.
  3. Paste this URL: https://mcp-moltmail.ethermail.io/mcp
  4. Click Connect. Sign in with your EtherMail wallet in the popup.
  5. Done. Try one of the example prompts below in a new chat.

Custom connectors require a paid Claude plan (Pro, Max, Team, or Enterprise).

  1. Open the Claude desktop app → Settings → Connectors.
  2. Click Add custom connector.
  3. Paste this URL: https://mcp-moltmail.ethermail.io/mcp
  4. Click Connect. A browser tab opens for the EtherMail sign-in.
  5. Return to Claude — the connector is live in any new chat.

Same flow as the web app; just lives in the native client. Paid plan required.

One-line install in your terminal:

claude mcp add --transport http moltmail https://mcp-moltmail.ethermail.io/mcp

Then inside Claude Code run /mcp, pick moltmail, and complete the OAuth flow once. The login opens in your default browser.

Prefer to edit config directly? Add this to ~/.claude.json:

{
  "mcpServers": {
    "moltmail": {
      "type": "http",
      "url": "https://mcp-moltmail.ethermail.io/mcp"
    }
  }
}

Scope it to a project by adding the same block to that project's .mcp.json instead.

ChatGPT (custom connectors)

  1. Open ChatGPT → Settings → Connectors (Developer Mode may need to be enabled for custom MCP).
  2. Click Create / Add custom connector.
  3. Paste this URL: https://mcp-moltmail.ethermail.io/mcp
  4. Authenticate with your EtherMail wallet when prompted.

Available on paid ChatGPT plans (Plus, Pro, Business, Enterprise) where MCP custom connectors are exposed.

OpenAI Responses API

Reference the MCP server inline when calling the Responses API. The API negotiates OAuth via the connector's dynamic client registration on first use:

const response = await client.responses.create({
  model: "gpt-5",
  input: "Any unread email in my MoltMail inbox?",
  tools: [{
    type: "mcp",
    server_label: "moltmail",
    server_url: "https://mcp-moltmail.ethermail.io/mcp",
    require_approval: "never"
  }]
});

Gemini CLI

Add the server to ~/.gemini/settings.json (or run gemini mcp add if your version supports the subcommand):

{
  "mcpServers": {
    "moltmail": {
      "httpUrl": "https://mcp-moltmail.ethermail.io/mcp"
    }
  }
}

Run gemini; on the first MoltMail tool call, the CLI opens the EtherMail sign-in in your browser.

Gemini Code Assist / Enterprise

In your workspace MCP settings, add a custom MCP server with URL https://mcp-moltmail.ethermail.io/mcp. The OAuth flow handles authentication on first use.

Exact menus vary by Gemini product version. Check your product's MCP docs if any step differs.

OpenClaw natively supports remote MCP servers over Streamable HTTP. Register MoltMail once and any OpenClaw agent on that workstation can use it.

One-line install

openclaw mcp set moltmail '{"url":"https://mcp-moltmail.ethermail.io/mcp","transport":"streamable-http"}'

On the first tool call OpenClaw runs the OAuth handshake automatically; the EtherMail sign-in opens in your browser.

Or edit the OpenClaw config directly

{
  "mcpServers": {
    "moltmail": {
      "url": "https://mcp-moltmail.ethermail.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Already using the MoltMail OpenClaw Skill?

The moltmail-skill is a code-installed Skill that ships with its own wallet management and CLI scripts. It's still supported, but the MCP connector is the recommended path going forward — same tools, OAuth-based sign-in, no local key storage.

Don't have a MoltMail account yet? Create one at moltmail.io first — takes < 30 seconds.

Example prompts

Drop any of these into your assistant once the connector is wired up. The assistant picks the right tool automatically.

"Any unread email in my MoltMail inbox?"
"Read my latest message and summarize it."
"Reply to the last email I got from alice@example.com saying I'll be on the call at 3pm."
"Send a draft email to my CTO with subject 'Q3 roadmap' and a 200-word body covering our connector launch."
"What's my current EMC balance?"
"What's my MoltMail referral code?"
"List all the aliases I can send from."

Tools

Every tool is annotated with the standard MCP readOnlyHint / destructiveHint markers, so any compliant client can reason about safety before invoking.

ToolWhat it does
list_mailboxesread Lists your mailboxes (Inbox, Sent, Drafts, Junk, Trash) with unread/total counters. Use it first to discover mailbox IDs.
search_emailsread Lists messages in a mailbox, newest first, with pagination. Returns subjects, senders, dates, and a short preview (intro). For full bodies, use get_email. Defaults to INBOX when no mailbox is specified.
get_emailread Fetches a single email's full HTML/text content and attachment metadata. Read-only — does not auto-mark seen.
mark_readwrite Marks a single message as read. Idempotent.
send_emailwrite Sends a new email. The assistant is instructed to confirm subject and body with you first. fromAddress defaults to your primary alias; pass any alias from list_aliases to override.
reply_emailwrite Replies to an existing message. Threads under the original via standard mail references.
list_aliasesread Lists the unique sender addresses available to you (wallet-derived + any custom aliases). Duplicates are removed automatically.
get_earned_coinsread Returns your available EMC (EtherMail Coin) balance from the rewards pool. Claimable as $EMT.
get_referral_coderead Returns your MoltMail referral code (your user id) for sharing with new signups.

Message badges

Some MoltMail messages carry a badge field. The connector tells the assistant how to highlight them by category when reading:

Security & privacy

Limits

Support

For bug reports, security disclosures, or directory-listing questions: support@ethermail.com.