Tmailor temporary email MCP server

tmailor-mcp

<!-- mcp-name: io.github.tmailor-com/tmailor-mcp -->

MCP server for the Tmailor Open API. It gives AI agents (Claude, Cursor, VS Code Copilot and any other MCP client) real, receive-only temporary email addresses: sign up somewhere, wait for the email, get the one-time code or the verification link.

You:   Sign up on example.com with a temporary email and confirm the account.
Agent: create_mailbox -> k3x9q2m7@picdirect.net
       (fills in the sign-up form)
       wait_for_message -> otp "482913", links ["https://example.com/confirm?t=..."]

Billing counts mailboxes, not requests: creating an address uses 1 unit of quota, while waiting for and reading mail is free. Addresses never expire.

Requirements

runs the MCP server under IP allowlist. Paid plans accept calls from any IP.

• A Tmailor API key: sign in at https://platform.tmailor.com and create one under API keys.
• uv (for uvx) or Python 3.10+.
• On the Free plan the API only accepts calls from your allowlisted IP: add the public IP of the computer that

Install

The server runs locally over stdio. The API key is read from the TMAILORAPIKEY environment variable.

Claude Code

claude mcp add tmailor -e TMAILOR_API_KEY=tmk_live_... -- uvx tmailor-mcp

Claude Desktop

Edit claudedesktopconfig.json (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "tmailor": {
      "command": "uvx",
      "args": ["tmailor-mcp"],
      "env": { "TMAILOR_API_KEY": "tmk_live_..." }
    }
  }
}

Cursor

~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) uses the same mcpServers block as above.

VS Code

.vscode/mcp.json. The key is asked once and stored by VS Code instead of being written in the file:

{
  "inputs": [
    { "type": "promptString", "id": "tmailor-key", "description": "Tmailor API key", "password": true }
  ],
  "servers": {
    "tmailor": {
      "type": "stdio",
      "command": "uvx",
      "args": ["tmailor-mcp"],
      "env": { "TMAILOR_API_KEY": "${input:tmailor-key}" }
    }
  }
}

Other MCP clients

tmailor-mcp is listed in the MCP Registry as io.github.tmailor-com/tmailor-mcp, so clients that browse the registry can install it directly.

Without uv

pip install tmailor-mcp
TMAILOR_API_KEY=tmk_live_... tmailor-mcp

Tools

bodyformat on waitformessage and readmessage: text (plain text, default, cut to maxchars), html (the raw HTML exactly as received, cut to maxhtmlchars, default 100000) or both. hashtml says whether the message has an HTML part; html on a message without one returns the text instead.

Tools take and return email addresses only. The address tokens of the API stay inside the server process, so they never end up in the conversation.

Security notes

Shortened. The full README is on GitHub.