Skip to content
MCP server

smails

Disposable receive-only inboxes so an agent can sign up and read verification codes

Install
Pricing
Free
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.1.0
Listing updated
3 days ago

About smails

smails is a free MCP server for communication. It can run locally on your machine or as a hosted remote server.

smails gives an AI agent a temporary email address it can use to register for a service, then wait for the verification message. The wait_for_message tool returns as soon as the email arrives with the full body, so the agent needs no polling loop.

Sign-in is through GitHub in the browser, and Claude Code or Codex keep the session, so there are no keys to paste. Each account can create 20 new inboxes a day, each lives for 7 days, and inboxes are receive-only.

The same tools are available from a command-line client that needs Node.js 22.18 or newer, with a wait command that exits with status 2 on timeout (120 seconds by default). Use the hosted MCP endpoint or run it locally over stdio. Version 0.1 removed the anonymous API, so login is now required.

Install

Run in a terminal

claude mcp add --transport http smails https://smails.dev/mcp

Add to Settings → Connectors → Add custom connector

https://smails.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "smails": {
      "url": "https://smails.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "smails": {
      "serverUrl": "https://smails.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

create_mailbox
Create a new inbox
wait_for_message
Wait for an email to arrive
list_messages
List messages in an inbox
read_message
Read one message
list_mailboxes
List active mailboxes
delete_message
Delete a message
whoami
Show account and daily quota

What it does

Wait for mail
wait_for_message returns when the email lands, with the whole body.
Short-lived inboxes
Each address lasts 7 days and is receive-only.
GitHub sign-in
Session is stored once; no keys to paste.
CLI included
Create, list, read and delete from a terminal or script.
Filters
Wait by sender, subject or time.
Remote or stdio
Hosted endpoint or local npx server.

Good for

  • Let an agent register for a service and read the code
  • Script signup tests that need email
  • Read a one-time message in CI
  • Clean up test mailboxes

Pricing

Free

Free to start; 20 new inboxes per day per account

Prices change. Check smails.dev before you buy.

smails FAQ

What does it cost?

The site says it is free to start, with 20 new inboxes a day per account.

How long do inboxes last?

7 days.

Can it send email?

No, inboxes are receive-only.

How do I sign in?

With GitHub, via /mcp in Claude Code or npx @smails/cli login.

Is smails free?

Yes. smails is free to use.

How do I add smails to Claude Code?

Run this command in your terminal: claude mcp add --transport http smails https://smails.dev/mcp

What are the best alternatives to smails?

The closest alternatives to smails are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to smails

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools