Skip to content
MCP server

Tmailor temporary email

Receive-only temporary email inboxes that agents create, wait on and read

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

About Tmailor temporary email

Tmailor temporary email is a freemium MCP server for communication. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • TMAILOR_API_KEYTmailor Open API key (create one at https://platform.tmailor.com/keys)Required

Tools this server provides (8)

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

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.

What it does

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

Pricing

Freemium

Free plan with IP allowlisting; paid plans add hosted server and any-IP access; prices not published here

Prices change. Check platform.tmailor.com before you buy.

Tmailor temporary email 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 to Tmailor temporary email

  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