@smails/cli

Disposable email for humans and AI agents. A throwaway inbox you can drive from the terminal — or plug into any AI agent as an MCP server, so it can receive verification codes and emails on its own. No signup.

→ smails.dev

CLI

npx @smails/cli create        # create a mailbox (token saved to ~/.smails)
npx @smails/cli inbox         # list messages
npx @smails/cli read <id>     # read a message (full id or short prefix)
npx @smails/cli delete <id>   # delete a message
npx @smails/cli whoami        # show the current address
npx @smails/cli create --force  # replace with a fresh mailbox

Install globally for a shorter command:

npm i -g @smails/cli
smails create

MCP server (for AI agents)

Add the server to any MCP client (e.g. Claude Desktop — ~/.claude/mcp.json, Cursor, etc.):

{
  "mcpServers": {
    "smails": {
      "command": "npx",
      "args": ["@smails/cli", "mcp"]
    }
  }
}

The agent can then create a mailbox and read incoming mail itself. Tools:

Tool	Description
create_mailbox	Create a throwaway mailbox
list_messages	List messages in the current mailbox
read_message	Read a message by id
delete_message	Delete a message by id
get_address	Get the current mailbox address

Config

• The current mailbox (address + token) is stored in ~/.smails.
• SMAILS_API_URL overrides the API base URL (default https://smails.dev).

Links

• Website: smails.dev
• Source: github.com/pexni/smails
• License: MIT