Tempmail MCP server

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:

{
  "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:

{
  "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
• TEMPMAILBASEURL 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

getemaildomains

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

getmessagedetail

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

getwebhookconfig

Get current webhook configuration information.

Parameters: None

setwebhookconfig

Set or update webhook configuration.

Parameters:

Shortened. The full README is on GitHub.