Repository navigation
Sign-in is now required. smails is now built for AI agents, and the anonymous API has been retired: it answers 410.
npx @smails/cli login: sign in once with GitHub using a device code. The CLI and the local MCP server share the session.- New commands:
wait(blocks until mail arrives and prints it; exits 2 on timeout),list,whoami(shows today's quota);--jsonon every command. smails mcpnow forwards to the remote MCP server. It adds alogintool, so an agent can sign you in by sending you a link.- Remote MCP server: add
https://smails.dev/mcpto any MCP client. - No runtime dependencies. Requires Node.js 22.18 or newer.
Upgrading from 0.0.x: mailboxes saved by older versions no longer work. Run npx @smails/cli login, then create.
Free plan: 20 new mailboxes per day; each mailbox lasts 7 days. Need a throwaway inbox in your own browser? Use https://smail.pw.