Mcp Server Tempmail
About
An MCP (Model Context Protocol) server for temporary email management using the ChatTempMail API.
Details
- Author
- Selenium39
- Downloads
- 305
- Categories
- Other
Jump to
- Create temporary emails with configurable expiry (1 hour, 1 day, 3 days, or permanent)
- Get all available email domains from the system
- View, list, and delete email messages
- Set and retrieve webhook configuration
- Paginated listings for emails and messages
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp Server TempmailCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Obtain an API key from chat-tempmail.com, then configure your MCP client (e.g., Claude Desktop, Cursor) with the tempmail server using npx mcp-server-tempmail and set the TEMPMAIL_API_KEY and optional TEMPMAIL_BASE_URL environment variables. After restarting the client, use natural language prompts to interact with the available tools.
get_email_domains
获取系统中所有可用的邮箱域名
create_email
创建新的临时邮箱地址
list_emails
获取账户下的所有邮箱地址
delete_email
删除指定的邮箱地址
get_messages
获取指定邮箱中的所有消息
get_message_detail
获取指定消息的详细内容
delete_message
删除指定的消息
get_webhook_config
获取当前的webhook配置信息
set_webhook_config
设置或更新webhook配置
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server tempmail": {
"tempmail": {
"command": "npx",
"args": [
"mcp-server-tempmail"
],
"env": {
"TEMPMAIL_API_KEY": "your-api-key-here",
"TEMPMAIL_BASE_URL": "https://chat-tempmail.com"
}
}
}
}
}McpServers
{
"tempmail": {
"command": "npx",
"args": [
"mcp-server-tempmail"
],
"env": {
"TEMPMAIL_API_KEY": "your-api-key-here",
"TEMPMAIL_BASE_URL": "https://chat-tempmail.com"
}
}
}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 emailsMessage Management
- ✅ Get email messages - ✅ View message details - ✅ Delete messagesWebhook Configuration
- ✅ Get webhook configuration - ✅ Set webhook configurationInstallation 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 page2. 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
MITContributing
Issues and Pull Requests are welcome.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
