Quickstart: MCP Server

1 Sign up

Create an account via the dashboard or with a single API call. You'll get an API key and a default mailbox like [email protected].

terminal

curl -X POST https://api.multimail.dev/v1/account \ -H "Content-Type: application/json" \ -d '{ "operator_name": "Greenline Studios", "slug": "greenline", "accepted_tos": true, "accepted_operator_agreement": true, "accepted_anti_spam_policy": true, "email_use_type": "transactional", "oversight_email": "[email protected]" }'

Check your oversight email for the activation code, then confirm:

terminal

curl -X POST https://api.multimail.dev/v1/confirm \
  -H "Authorization: Bearer mm_live_..." \
  -d '{"code": "SKP-7D2-4V8"}'
          

2 Create a mailbox

Your account includes a default mailbox. Create additional ones as needed. Each mailbox gets its own email address and oversight mode.

terminal

curl -X POST https://api.multimail.dev/v1/mailboxes \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "address_local_part": "support-bot",
    "display_name": "Support Agent",
    "oversight_mode": "gated_send"
  }'
          

response

{ "id": "01JMXK9F2A...", "address": "[email protected]", "display_name": "Support Agent", "oversight_mode": "gated_send" }

3 Install the MCP server

Option A: Remote server (recommended). No install. Connect directly to our hosted MCP server with OAuth authentication.

claude_desktop_config.json

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}
          

Option B: Local server (stdio). Run via npx. Pass your API key and optional default mailbox ID as environment variables.

claude_desktop_config.json

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_your_key_here",
        "MULTIMAIL_MAILBOX_ID": "01JMXK9F2A..."
      }
    }
  }
}
          

Restart Claude Desktop. You should see 37 email tools available in your tool list.

4 Send your first email

Ask Claude to send an email. It will use the send_email tool automatically.

Claude Desktop

You

Send a welcome email to [email protected] introducing our new support bot.

Claude

I'll send that email now.

send_email
to: ["[email protected]"]
subject: "Welcome to Greenline Support"
markdown: "Hi Alice,\n\nI'm the new support agent for Greenline Studios. I can help you with:\n\n- Account questions\n- Billing inquiries\n- Technical support\n\nJust reply to this email anytime.\n\nBest,\nSupport Agent"

Done. The email has been queued for delivery. Since your mailbox is in gated_send mode, your operator at [email protected] will receive an approval notification. Once approved, the email will be delivered to Alice.

From zero to agent email in 3 minutes

Keep going

Full API docs

Common patterns

Oversight modes

Integrations