# ClankerMails

> Programmable email inboxes for workflows and bots, accessible via REST API and signed webhooks with parsed JSON — no SMTP or IMAP required.

ClankerMails gives workflows, scripts, and bots real email addresses that behave like APIs. Built by Lambda Symbolics OÜ, it lets developers create inboxes instantly over a REST API, receive signed webhooks when mail arrives, and read fully parsed JSON messages — without touching SMTP, IMAP, or email server configuration.

## What It Is

ClankerMails is a programmable inbound email service designed for developers and AI agents. Instead of wiring up a mail server or fighting Gmail API quotas, you POST to an endpoint, get a live email address (e.g. `mybot@clankermails.com`), and immediately start receiving mail as structured JSON. The service handles domains, DNS, DKIM, SPF, and DMARC so you don't have to.

## How the API Works

Every inbox is created and managed through a REST API authenticated with a Bearer token. Key endpoints include:

- **POST /v1/inboxes** — create an inbox with a chosen local part and optional webhook URL
- **GET /v1/inboxes/{id}/messages** — poll for messages with cursor-based pagination and `unread_only` filtering
- **GET /v1/messages/{id}** — retrieve a full message including `from`, `to`, `subject`, `text`, `html`, `headers`, and attachments
- **PATCH /v1/inboxes/{id}** — update webhook URL or inbox status
- **GET /v1/attachments/{id}** — download attachments directly

Webhooks are signed with HMAC-SHA256 and verified via the `X-ClankerMails-Signature` header, with exponential backoff retries on failure. The API rate limit is 60 requests per minute per API key.

## AI Agent and MCP Integration

ClankerMails includes a hosted MCP (Model Context Protocol) server at `https://clankermails.com/mcp`. Claude Desktop users can add it via `claude_desktop_config.json` with no local install — just a URL and an API key. The docs note compatibility with ChatGPT, Claude, OpenClaw, and any other MCP-compatible client. This makes it straightforward to give an AI agent its own persistent email address that it can manage autonomously within a chat session.

## What Developers Wire Up

The service is designed for a range of inbound email automation use cases:

- **Automations and integrations** — turn inbound mail into events for Zapier, Make, n8n, or custom servers
- **Alerts and monitoring** — route GitHub, Stripe, or Sentry alerts to a handler that acts on them
- **Parsing and data capture** — extract fields from invoices, receipts, and confirmations into a database
- **AI agents and bots** — give Claude, ChatGPT, or OpenClaw a dedicated address
- **Forwarding and filtering** — forward to a real inbox with per-sender allow/block lists
- **Digests and newsletters** — aggregate newsletters into a daily digest

## Setup Path

Sign up with Google or email, create an inbox from the dashboard or API, then point code at the REST endpoint or configure a webhook. The docs include a ready-to-paste instruction block for AI bots, letting an agent handle the entire setup autonomously. No SMTP credentials, OAuth token refreshes, or MIME parsing libraries are needed on the developer's side.

## Features
- Programmable email inboxes via REST API
- Signed webhooks with HMAC-SHA256 verification
- Parsed JSON messages (from, to, subject, text, HTML, headers, attachments)
- No SMTP, IMAP, or DNS setup required
- Hosted MCP server for AI agent integration
- Cursor-based message pagination with unread filtering
- Exponential backoff webhook retries
- Per-sender allow and block lists for forwarding
- Multiple custom domains supported
- API key authentication
- Attachment download endpoint
- Inbox status management

## Integrations
Zapier, Make, n8n, Claude Desktop, ChatGPT, OpenClaw, GitHub, Stripe, Sentry

## Platforms
WEB, API

## Pricing
Freemium — Free tier available with paid upgrades

## Links
- Website: https://clankermails.com
- Documentation: https://clankermails.com/guide
- EveryDev.ai: https://www.everydev.ai/tools/clankermails