Email inboxes for AI agents: create an inbox, then block until the OTP or magic link arrives.
One address for any MCP client. Your key stays in your Odel vault.
At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Odel could not list its tools without signing in.
mailsocket is an inbox API for OTP and magic-link
signup automation: email in, JSON out. GET /inboxes/{id}/messages/wait?require=otp blocks and returns the OTP the
instant it arrives — no polling, no IMAP. Built for signup automation, E2E
tests, and AI agents.
This repo holds the official client packages.
| Package | Install | Docs |
|---|---|---|
| Python | pip install mailsocket | python/ |
| TypeScript / Node | npm i mailsocket-sdk | typescript/ |
| MCP server (AI agents) | uvx mailsocket-mcp | mcp/ |
Full docs: mailsocket.app · dash.mailsocket.app/docs/
Point any MCP-compatible client (Claude Desktop, Cursor, Claude Code) at the
mailsocket-mcp server over stdio:
{
"mcpServers": {
"mailsocket": {
"command": "uvx",
"args": ["mailsocket-mcp"],
"env": {
"MAILSOCKET_API_KEY": "ms_live_..."
}
}
}
}
See mcp/README.md for per-client config file locations and the full tool list.
examples/playwright/ — a reference Playwright test that fills a signup form with a mailsocket inbox address and blocks on the wait endpoint until the OTP arrives.
MIT — see LICENSE.