# Tmailor temporary email

> Tmailor temporary email is a freemium MCP server for communication. Receive-only temporary email inboxes that agents create, wait on and read. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://platform.tmailor.com/docs
- **Repository:** https://github.com/tmailor-com/tmailor-mcp
- **MCP Registry name:** io.github.tmailor-com/tmailor-mcp
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-14

## About

Agents that sign up for services hit a wall at the confirmation email. This server gives them real temporary addresses they can create, wait on and read, then follow the link inside. The README's example has an agent create a mailbox, fill in a sign-up form and call wait_for_message to get the confirmation link.

Billing counts mailboxes rather than requests: creating an address uses one unit of quota, while waiting for and reading mail is free, and addresses never expire. Addresses are random on a shared domain, or a chosen name on a domain you have verified.

The package runs locally over stdio with a Tmailor API key from platform.tmailor.com; paid plans can instead use the hosted server at mcp.tmailor.com with OAuth. On the Free plan the API only accepts calls from an allowlisted IP, so you add the public IP of the machine running the server. Message bodies can be returned as text, HTML or both.

## Features

- **Create temporary mailboxes:** Random addresses on a shared domain or named ones on your own verified domain.
- **Wait for a message:** wait_for_message blocks up to 300 seconds, with optional sender and subject filters.
- **Links extracted:** Messages come back with the links found in them.
- **Read as text or HTML:** body_format chooses plain text, raw HTML or both.
- **Per-mailbox quota:** Only mailbox creation uses quota; reading mail is free.
- **Hosted option:** Paid plans can use the hosted server with OAuth instead of installing.

## Good for

- Let an agent confirm a new account sign-up
- Test a product's verification email flow
- Pull a one-time code from an email into a script
- Keep throwaway addresses off a personal inbox

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tmailor-mcp https://mcp.tmailor.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tmailor.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tmailor-mcp": {
      "url": "https://mcp.tmailor.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tmailor-mcp": {
      "type": "http",
      "url": "https://mcp.tmailor.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tmailor-mcp": {
      "serverUrl": "https://mcp.tmailor.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tmailor-mcp": {
      "type": "http",
      "url": "https://mcp.tmailor.com/mcp"
    }
  }
}
```

## Tools

- `create_mailbox`: Create an address, random or on your own verified domain; uses 1 quota unit.
- `wait_for_message`: Return the newest unread matching message or wait up to 300 seconds.
- `list_messages`: List an address's messages from the last 24 hours without bodies.
- `read_message`: Read one message with its links and body.
- `delete_mailbox`: Delete an address for good.
- `list_mailboxes`: List your addresses, newest first.
- `list_domains`: Show your own domains and whether shared domains are available.
- `account_status`: Show remaining quota and plan.

## FAQ

### Can it send email?

No. The addresses are receive-only.

### What uses quota?

Creating a mailbox uses 1 unit. Waiting for and reading mail is free.

### Do addresses expire?

The README says addresses never expire.

### What is different on the Free plan?

The API only accepts calls from your allowlisted IP address; paid plans accept any IP.

### Is Tmailor temporary email free?

Tmailor temporary email has a free plan, with paid plans for more usage or features.

### How do I add Tmailor temporary email to Claude Code?

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

### What are the best alternatives to Tmailor temporary email?

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/tmailor-temporary-email
