io.github.Selenium39/mcp-server-tempmail

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.