Mcp Server Tempmail

by Selenium39

379 downloads Not rated yet

GitHub Website

Other

About

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

Explore

- 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 Tempmail

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

- ✅ Get webhook configuration
- ✅ Set webhook configuration

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: - Replaceyour-api-key-herewith your actual API key from chat-tempmail.com -TEMPMAIL_BASE_URL is optional and defaults to https://chat-tempmail.com if not specified


Get current webhook configuration information.



Parameters: None

Set or update webhook configuration. Parameters: -url(required): Webhook URL address -enabled` (required): Whether to enable webhook

`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 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
  -

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

get_email_domains

create_email

list_emails

delete_email

get_messages

get_message_detail

delete_message

get_webhook_config

set_webhook_config

Claude Desktop / Cursor

McpServers

MCP Server - Temporary Email

Features

Email Management

Message Management

Webhook Configuration

Installation and Usage

1. Get API Key

2. Configure MCP Client

3. Restart Application

MCP Tools Documentation

Email Management Tools

get_email_domains

create_email

list_emails

delete_email

Message Management Tools

get_messages

get_message_detail

delete_message

Webhook Configuration Tools

get_webhook_config

set_webhook_config

Usage Examples

Get Available Domains

Create Temporary Email

View Email Messages

View Message Details

Notes

License

Contributing

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`get_email_domains`

`create_email`

`list_emails`

`delete_email`

`get_messages`

`get_message_detail`

`delete_message`

`get_webhook_config`

`set_webhook_config`