smails

io.github.pexniPublished by GitHub account pexniv0.1.0Updated Nov 5, 2026

Disposable email inboxes for AI agents: create an address, wait for the verification email.

VerifiedStreamable HTTPWeb executableDeveloper ToolsCommunication & Collaboration

Overview

AI-generated overview

Gives AI agents disposable email inboxes: create an address, wait for the verification email, and read the code.

What you can do
  • Create and list disposable mailboxes, with a new mailbox becoming the current one
  • Wait for incoming mail, filtered by sender, subject, timeout or since time
  • List, read and delete messages in a mailbox
  • Sign in with GitHub and check the account and today's quota
When to use it
Useful when an agent needs to sign up for a service that requires email verification and must fetch the confirmation code or link without using a real personal inbox.
Requirements
Remote endpoint at smails.dev over streamable HTTP, or the local npm package @smails/cli run with Node.js 22.18 or newer. Sign-in with GitHub is required, either through the login tool or the CLI login command; the session is stored in a local credentials file. OAuth authentication is declared.
Before you install
Signing in links a GitHub account and stores a session credential on the machine. Mailboxes are disposable and the README notes that older saved mailboxes no longer work after the 0.1 upgrade. Messages can be deleted, and mail content is held by the smails.dev service.

Installation

In SourceWeft

  1. Open smails in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.pexni%2Fsmails/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "smails": {
      "type": "http",
      "url": "https://smails.dev/mcp"
    }
  }
}

README

@smails/cli

[npm]

Disposable email for AI agents. Create an inbox, use the address to sign up somewhere, and wait for the verification code — from a terminal, a script, Claude Code or Codex.

→ smails.dev

Requires Node.js 22.18 or newer. No runtime dependencies.

Sign in (once)

bash
npx @smails/cli login

It prints a link and opens your browser: sign in with GitHub and confirm the code. The session is stored in ~/.config/smails/credentials.json and shared with the MCP server below.

Get a verification code

bash
npx @smails/cli create                    # → [email protected]npx @smails/cli wait --subject code       # blocks until it arrives, prints the messagenpx @smails/cli wait --json | jq -r .text # in scripts

wait exits with status 2 if nothing arrives before --timeout (default 120 s).

Commands

Command
login / logout / whoamiAccount and today's quota
createNew mailbox; becomes the current one
listYour active mailboxes
inbox [address]Messages (default: current mailbox)
read <id>One message (short id prefix works)
wait [address]Wait for new mail: --from, --subject, --timeout, --since
delete <id>Delete a message
mcpRun the MCP server over stdio

Add --json for machine-readable output. npm i -g @smails/cli to type smails instead of npx @smails/cli.

MCP server

Remote (recommended) — or just tell your agent: Set up smails for me by following https://smails.dev/setup.md

bash
claude mcp add --transport http --scope user smails https://smails.dev/mcp   # Claude Code, then /mcp to sign incodex mcp add smails --url https://smails.dev/mcp && codex mcp login smails  # Codex

Local (stdio):

bash
claude mcp add smails -- npx -y @smails/cli mcp   # Claude Codecodex mcp add smails -- npx -y @smails/cli mcp    # Codex

Sign in with npx @smails/cli login, or let the agent call the login tool, which returns a link for you to confirm. Tools: create_mailbox, wait_for_message, list_messages, read_message, list_mailboxes, delete_message, whoami.

Upgrading from 0.0.x

0.1 requires signing in; the anonymous API is gone and old saved mailboxes no longer work. Run npx @smails/cli login, then create.

Environment

SMAILS_URL — server to use (default https://smails.dev).

License

MIT

Source: cli/README.md at commit 815dbe0

Tools

1

login

Sign in to smails

Sign in to smails with GitHub. The first call returns a link for the user to open and confirm; call login again after they confirm. Only needed once per machine.

Takes no parameters.

Version history

2
  1. v0.1.0LatestNov 5, 2026
  2. v0.0.12Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts