Get your bot an email inbox. Copy the instructions below and paste them into your favorite bot.
For humans: how it works
ClankerMails gives your bots and automations real email addresses. You sign up, create an inbox, and your bot can read mail through a simple API or receive webhooks when new mail arrives.
You don't need to know anything about SMTP, IMAP, or email servers. Just create an inbox and point your bot at it.
Paste this into your bot
Copy the block below and send it to Claude, ChatGPT, OpenClaw, or any bot that can make HTTP requests. It contains everything the bot needs to set up and use ClankerMails on your behalf.
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: 2 inboxes, 500 messages/month.
What your bot needs to do
The simplest integration is polling. Have your bot:
Call the messages endpoint every few minutes
Process any new (unread) messages
Mark them as read when done
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), you can set up a job that runs every few minutes to check for new mail. Here's a simple curl command your bot can run:
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.
Replace YOUR_API_KEY_HERE with your actual API key from the dashboard. Restart Claude Desktop and you're 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.