DropMail

About DropMail

DropMail is a disposable email API for programmatic testing and automation. It lets developers create temporary email addresses without registering an account, receive incoming messages in real time, and read message contents through a GraphQL interface. Access is authenticated using free tokens that do not require sign-up, and the API can be queried over HTTP or subscribed to via WebSocket for push notifications of new mail.

The service is built around a session model: a session is a server-side storage unit with a limited lifetime (10 minutes by default, extended on access) that holds one or more email addresses and the mail they receive. When a session expires, its addresses and stored mail are permanently deleted. Addresses can be created on a chosen domain, with the address's local part assigned automatically by the server; addresses can be restored later using a saved restore key. Users can also add their own domains for use with the service. Received mail can be queried for specific parts (plain text, subject, attachments) or retrieved as raw MIME content or via a download URL.

DropMail is intended for use cases such as automated testing, user onboarding flows, and AI agents that need a live, temporary inbox. It provides an MCP server package (available on PyPI) that exposes its functionality as tools for AI assistants like Claude Desktop, VS Code Copilot, and GitHub Copilot CLI, allowing an AI agent to create an inbox, wait for an email, and read its contents without direct GraphQL usage. Rate limiting applies based on the token used.

Key features

• Programmatically create disposable email addresses via GraphQL API
• Receive incoming mail in real time via WebSocket or long-poll subscriptions
• Read full email contents including plain text, headers, and attachments
• Add custom personal domains for receiving mail
• MCP server package exposes DropMail as tools for AI assistants like Claude Desktop and Copilot

Frequently asked questions