Skip to main content
Mailera

MCP

Use Mailera in Claude

Add Mailera's MCP server to Claude Code with one command, or to Claude Desktop via the mcp-remote bridge. Claude can read, search, and reply to messages across your connected mailboxes.

Official Claude docs

Before you start

  1. Create a free workspace and connect at least one mailbox.
  2. Go to Settings → API key, create a key, and select permissions. The read permission is enough to get started.
  3. Copy the key as soon as you create it — Mailera only shows the full key once.

Setup

Claude Code

  1. Open a terminal in your project directory and run the command below, substituting your own key.
  2. In Claude Code, type /mcp: mailera should show a connected status and list its tools.

Replace mh_live_xxx with your API key.

Terminal
claude mcp add --transport http mailera https://mailera.app/api/public/v1/mcp \  --header "Authorization: Bearer mh_live_xxx"

Claude Desktop

  1. Install Node.js 18 or later — the mcp-remote bridge runs via npx.
  2. In Claude Desktop, open Settings → Developer → Edit Config, paste the mailera block into mcpServers, and save.
  3. Quit Claude Desktop completely and reopen it. Mailera's tools appear under the tools button in the chat pane.

Replace mh_live_xxx with your API key.

claude_desktop_config.json
{  "mcpServers": {    "mailera": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mailera.app/api/public/v1/mcp",        "--header",        "Authorization:${AUTH_HEADER}"      ],      "env": {        "AUTH_HEADER": "Bearer mh_live_xxx"      }    }  }}

Connectors (custom connector) on claude.ai and Claude Desktop don't yet work with Mailera: they only support servers that use OAuth or require no authentication, while Mailera uses an API key.

Check the connection

Ask the agent: “List my Mailera mailboxes”. The agent calls list_mailboxes and returns your mailboxes with their sync status. Then try: “Find the latest email message from noreply@… and extract the OTP”.

Tool list and safety guidance

Common errors

401 unauthorized
The key is invalid, has been revoked, or is missing Bearer. The header must be Authorization: Bearer mh_live_…
Can't find send_email or rescue_spam
The key lacks the required permissions (send, move). Mailera only shows tools matching its permissions — create a new key with the permissions you need.
The agent can't find any mailboxes
The key is restricted to a group with no mailboxes, or the workspace has no connected mailboxes.
429 rate_limited
This key has exceeded 300 requests per minute. Wait the number of seconds specified in Retry-After, then try again.

Other apps

Use Mailera in Claude

Go to Settings → API key, create a key, and select permissions. The read permission is enough to get started.

Create a free workspace