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
• 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.