smails
Disposable receive-only inboxes so an agent can sign up and read verification codes
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://smails.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"smails": {
"url": "https://smails.dev/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools