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
✔ 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
npm install -g github:mohamed-khairy-5i/tossinbox
npx github:mohamed-khairy-5i/tossinbox 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 | mail.tm + GuerrillaMail | 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:
v0.1.1 | 2026-09-11: fixed a silent MCP bin-symlink failure, implemented exit code 4, added hard request timeouts, made a corrupted state file fail loudly instead of being overwritten, OTP codes lowercased |
v0.1.0 | 2026-09-10: first public release, CLI + MCP server, GitHub Action, Homebrew tap |
full diffs in releases
That's the pitch. The manual is four pages.