ClankerMails
Log in Start free

Setup guide

Give your workflow, script, or bot a real email inbox. The fastest path: copy the instructions below and paste them into your favorite bot, which will wire it up for you.

How it works

ClankerMails gives your workflows, scripts, and bots real email addresses. You sign up, create an inbox, and your code can read mail through a simple API or receive signed webhooks when new mail arrives.

You do not need to know anything about SMTP, IMAP, or email servers. Create an inbox and point your code at it. If you run an AI agent like Claude, ChatGPT, or OpenClaw, it can do all of this for you, including over MCP.

Paste this into your bot

Copy the block below and send it to any bot that can make HTTP requests. It contains everything the bot needs to set up and use ClankerMails on your behalf.

Instructions for your bot 
You are helping me set up ClankerMails, a service that gives bots real email inboxes.

BASE URL: https://clankermails.com
AUTH: All API calls use Bearer token authentication.
  Header: Authorization: Bearer <api_key>

SETUP STEPS:
1. I need to sign up at https://clankermails.com/register (or /login if I have an account)
2. After signing in, I go to the dashboard and create an API key
3. With the API key, you can manage inboxes and read mail for me

AVAILABLE DOMAINS:
GET /v1/domains (no auth needed)
Returns: { "domains": [{ "domain": "clankermails.com", "is_default": true }, ...] }

CREATE AN INBOX:
POST /v1/inboxes
Body: { "local_part": "mybot", "domain": "clankermails.com" }
Optional: "webhook_url", "display_name"
Returns the inbox with its email address.

LIST INBOXES:
GET /v1/inboxes

LIST MESSAGES:
GET /v1/inboxes/{inbox_id}/messages
Query params: limit (max 100), cursor, unread_only (true/false)

READ A MESSAGE:
GET /v1/messages/{message_id}
Returns full message with from, to, subject, text, html, headers, attachments.

MARK AS READ:
POST /v1/messages/{message_id}/read

MARK AS UNREAD:
POST /v1/messages/{message_id}/unread

DELETE A MESSAGE:
DELETE /v1/messages/{message_id}

DOWNLOAD ATTACHMENT:
GET /v1/attachments/{attachment_id}

UPDATE INBOX (set webhook, change status):
PATCH /v1/inboxes/{inbox_id}
Body: { "webhook_url": "https://...", "status": "active" }

DELETE INBOX:
DELETE /v1/inboxes/{inbox_id}

WEBHOOKS:
When configured, ClankerMails POSTs to your webhook_url when mail arrives.
The payload includes the full message. Payloads are signed with HMAC-SHA256
using the webhook_secret (shown in the dashboard). Verify with the
X-ClankerMails-Signature header. Retries with exponential backoff on failure.

EXAMPLE WORKFLOW - check for new mail every 5 minutes:
1. Create inbox: POST /v1/inboxes with local_part of your choice
2. Poll: GET /v1/inboxes/{id}/messages?unread_only=true
3. Process each message, then mark read: POST /v1/messages/{id}/read

RATE LIMITS: 60 requests per minute per API key.
FREE TIER (Sandbox): 1 inbox, 50 messages/month, 1-day retention.

What your bot needs to do

The simplest integration is polling. Have your bot:

If your bot can receive HTTP requests, set up a webhook instead and get notified instantly when mail arrives.

For bots that can run scheduled tasks

If your bot supports cron jobs or periodic tasks (like OpenClaw), set up a job that runs every few minutes to check for new mail:

Poll for unread messages 
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://clankermails.com/v1/inboxes/YOUR_INBOX_ID/messages?unread_only=true"

Use with Claude Desktop (MCP)

ClankerMails has a built-in MCP server. Add it to Claude Desktop and Claude can create inboxes, read messages, and manage everything for you directly in the chat. No install needed, just a URL and your API key.

Add this to your claude_desktop_config.json:

claude_desktop_config.json 
{
  "mcpServers": {
    "clankermails": {
      "type": "url",
      "url": "https://clankermails.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your actual API key from the dashboard. Restart Claude Desktop and you are set.

Use with other MCP clients

Any tool that supports MCP over HTTP can use ClankerMails. Point it at https://clankermails.com/mcp with your API key as a Bearer token. Works with ChatGPT, Claude, and any other MCP-compatible client.

Ready to start?

Create your free account and get an inbox in under a minute.

Sign up free