tossinbox · disposable email for AI agents
TossInbox: disposable email CLI and MCP server for AI agents. Spawn an inbox.
Get the code.
Toss it._
Built agent-first: --json on every command,
exit codes documented 0-4, zero interactive prompts.
$ brew install mohamed-khairy-5i/tap/tossinbox
$ npx tossinbox@latest spawn
✔ Inbox ready : qwd6996p1lbc@uberip.com
provider : mailtm
$ tossinbox wait --code --from noreply@example.com
✔ code received
from : ExampleApp <noreply@example.com>
code : 9378412
$ tossinbox toss
✔ tossed qwd6996p1lbc@uberip.com
# gone from the server. gone from disk.
What is TossInbox?
TossInbox is a disposable email CLI and MCP server. One command spawns a
throwaway inbox on a real mail provider; a second waits for the verification code and prints it;
a third deletes the inbox. Humans read the output, agents parse the --json.
No sign-up, no ads, no browser.
Install
Requires Node.js 18+. No accounts, no API keys, no config files. Four ways in, pick one.
brew install mohamed-khairy-5i/tap/tossinbox
npx tossinbox@latest spawn
git clone https://github.com/mohamed-khairy-5i/tossinbox.git && cd tossinbox && npm install && npm run build
Why TossInbox
Disposable email already exists as ad-covered websites and as human-first CLI wrappers around a dead upstream API. TossInbox is the one built for programs.
tossinbox spawngives you a real inbox on a live provider. No sign-up, no browser, no ads.tossinbox wait --codeblocks until the verification email lands, prints the code, exits clean. Script it.tossinbox tossdeletes the inbox. Gone from the server, gone from disk.
| Feature | TossInbox | temp-mail websites | tmpmail-era CLIs |
|---|---|---|---|
| JSON on every command | --json | no | rarely |
| Documented exit codes | 0-4 | none | no |
| MCP server for agents | yes, built in | no | no |
| Runs headless / in CI | yes | no | partial |
| Upstream providers alive | 7 providers · 4 independent stacks · automatic failover when one is down · attachments on read | varies | many wrap the dead 1secmail |
| Ads, trackers, popups | none | the business model | none |
Checked September 2026. If a cell is wrong, open an issue and win the argument.
Changelog. What actually shipped, per version — full diffs in releases.
The docs directory
Eight short pages, no fluff. Machines take the same list from
llms.txt.
$ ls docs/
That's the pitch. The manual is eight pages.