Mcp Server Tempmail

io.github.Selenium39Published by GitHub account Selenium39v1.0.1Updated Oct 27, 2026

MCP server for temporary email management using ChatTempMail API

VerifiedSTDIODesktop onlyDeveloper ToolsCommunication & Collaboration

Overview

AI-generated overview

MCP server that lets an assistant create and manage disposable temporary email addresses and read their messages through the ChatTempMail API.

What you can do
  • List available domains and create, list or delete temporary email addresses with a chosen expiry time
  • Read messages in an address, open message details, and delete messages
  • Get and set the webhook configuration (URL and enabled flag) for the account
When to use it
Useful when you need throwaway inboxes for sign-up confirmations, verification codes or test flows, and want the assistant to create addresses and read incoming mail without touching a personal mailbox.
Requirements
Runs locally over stdio, typically via npx from the npm package. Needs a ChatTempMail account and an API key supplied in the TEMPMAIL_API_KEY environment variable; TEMPMAIL_BASE_URL is optional and defaults to the hosted service. Network access to the ChatTempMail API is required.
Before you install
The API key in TEMPMAIL_API_KEY grants access to your account and should be kept private. The assistant can delete email addresses and messages and change webhook settings, so those actions are destructive or outward-facing. Message contents and webhook URLs are sent to the third-party ChatTempMail service.

Installation

In SourceWeft

  1. Open Mcp Server Tempmail in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP Server - Temporary Email

An MCP (Model Context Protocol) server for temporary email management using the ChatTempMail API.

中文文档

Features

Email Management

  • ✅ Get available domains
  • ✅ Create temporary emails
  • ✅ List emails
  • ✅ Delete emails

Message Management

  • ✅ Get email messages
  • ✅ View message details
  • ✅ Delete messages

Webhook Configuration

  • ✅ Get webhook configuration
  • ✅ Set webhook configuration

Installation and Usage

1. Get API Key

  1. Visit chat-tempmail.com
  2. Register an account and login
  3. Create an API key in your profile page

2. Configure MCP Client

Add the configuration to your MCP client (Claude Desktop, Cursor, etc.), make sure to set the API key in environment variables:

Install from source:

json
{  "mcpServers": {    "tempmail": {      "command": "npx",      "args": [        "--from",        "git+https://github.com/Selenium39/mcp-server-tempmail.git",        "mcp-server-tempmail"      ],      "env": {        "TEMPMAIL_API_KEY": "your-api-key-here",        "TEMPMAIL_BASE_URL": "https://chat-tempmail.com"      }    }  }}

Install from package manager:

json
{  "mcpServers": {    "tempmail": {      "command": "npx",      "args": ["mcp-server-tempmail"],      "env": {        "TEMPMAIL_API_KEY": "your-api-key-here",        "TEMPMAIL_BASE_URL": "https://chat-tempmail.com"      }    }  }}

⚠️ Important:

  • Replace your-api-key-here with your actual API key from chat-tempmail.com
  • TEMPMAIL_BASE_URL is optional and defaults to https://chat-tempmail.com if not specified

3. Restart Application

Restart your MCP client application after configuration.

MCP Tools Documentation

Email Management Tools

get_email_domains

Get all available email domains in the system.

Parameters: None

create_email

Create a new temporary email address.

Parameters:

  • name (required): Email prefix name
  • domain (required): Email domain
  • expiryTime (required): Expiry time in milliseconds, options:
    • 3600000 - 1 hour
    • 86400000 - 1 day
    • 259200000 - 3 days
    • 0 - permanent
list_emails

Get all email addresses under your account.

Parameters:

  • cursor (optional): Pagination cursor
delete_email

Delete the specified email address.

Parameters:

  • emailId (required): Email ID

Message Management Tools

get_messages

Get all messages in the specified email address.

Parameters:

  • emailId (required): Email ID
  • cursor (optional): Pagination cursor
get_message_detail

Get detailed content of the specified message.

Parameters:

  • emailId (required): Email ID
  • messageId (required): Message ID
delete_message

Delete the specified message.

Parameters:

  • emailId (required): Email ID
  • messageId (required): Message ID

Webhook Configuration Tools

get_webhook_config

Get current webhook configuration information.

Parameters: None

set_webhook_config

Set or update webhook configuration.

Parameters:

  • url (required): Webhook URL address
  • enabled (required): Whether to enable webhook

Usage Examples

Get Available Domains

Please get all available email domains.

Create Temporary Email

Please create an email named "test" using domain "chat-tempmail.com" with 1 hour validity.

View Email Messages

Please view all messages in email ID "c2c4f894-c672-4d5b-a918-abca95aff1f7".

View Message Details

Please view the detailed content of message ID "fd13a8df-1465-4fbc-a612-ca7311c31ff2" in email ID "c2c4f894-c672-4d5b-a918-abca95aff1f7".

Notes

  • API key is configured through the TEMPMAIL_API_KEY environment variable, please keep it secure and do not expose it publicly
  • Base URL can be customized through the TEMPMAIL_BASE_URL environment variable (defaults to https://chat-tempmail.com)
  • Temporary emails will automatically expire according to the set expiry time
  • Use nextCursor for paginated queries to get more data
  • Make sure to set the environment variables correctly in your MCP client configuration

License

MIT

Contributing

Issues and Pull Requests are welcome.

Source: README.md at commit dea629f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.