smails

io.github.pexni由 GitHub 帳號 pexni 發布v0.1.0更新於 Nov 5, 2026

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

已驗證Streamable HTTP可網頁執行開發者工具溝通與協作

概覽

AI 產生的概覽

為 AI 代理提供一次性信箱：建立地址、等待驗證郵件並讀取驗證碼。

可以做什麼
  • 建立與列出一次性信箱，新信箱會成為目前信箱
  • 等待新郵件，可依寄件者、主旨、逾時時間或起始時間篩選
  • 列出、讀取與刪除信箱中的郵件
  • 使用 GitHub 登入，並查看帳號與當日配額
適用情境
適合代理需要註冊要求電子郵件驗證的服務，並取得確認碼或確認連結，而不想使用真實個人信箱的情境。
執行需求
可透過 streamable HTTP 連線 smails.dev 遠端端點，或使用 Node.js 22.18 以上版本執行本機 npm 套件 @smails/cli。必須以 GitHub 登入，可透過 login 工具或 CLI 的 login 指令完成；工作階段會存放在本機憑證檔案中。宣告使用 OAuth 驗證。
安裝前請注意
登入會連結 GitHub 帳號並在本機儲存工作階段憑證。信箱為一次性，README 說明 0.1 升級後舊的已儲存信箱不再可用。郵件可被刪除，郵件內容由 smails.dev 服務保存。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 smails，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.pexni%2Fsmails/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "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

來源：cli/README.md，提交 815dbe0

工具

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.

無需輸入參數。

版本歷史

2
  1. v0.1.0最新Nov 5, 2026
  2. v0.0.12Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分