Email MCP
About
An MCP Server enabling POP3 and SMTP functionality for compatable AI Agents
Details
- Author
- gaddobenedetti
- Downloads
- 162
- Categories
- Communication
Jump to
- pollEmails(): returns IDs and headers of all stored emails.
- getEmailsById(ids): returns message IDs and bodies for specified emails.
- deleteEmailsById(ids): deletes given emails from the inbox.
- sendTextEmail(): sends a plain text email via SMTP.
- sendHtmlEmail(): sends an HTML formatted email via SMTP.
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
Email MCPCommand (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
Install by adding a configuration entry to the Claude Desktop developer config file, specifying the absolute path to the server directory and the required environment variables (EMAIL_USER, EMAIL_PASS, POP3_SERVER, POP3_PORT, SMTP_SERVER, SMTP_PORT). The server is run with uv run main.py. Once connected, the LLM can call the five provided tools to manage emails.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"email mcp": {
"mcp_email": {
"command": "uv",
"args": [
"--directory",
"/Absolute/path/to/server/directory",
"run",
"main.py"
],
"env": {
"EMAIL_USER": "Email account username",
"EMAIL_PASS": "Email account password",
"POP3_SERVER": "POP3 Server Address",
"POP3_PORT": "POP3 Server Port Number",
"SMTP_SERVER": "SMTP Server Address",
"SMTP_PORT": "SMTP Server Port Number"
}
}
}
}
}McpServers
{
"mcp_email": {
"command": "uv",
"args": [
"--directory",
"/Absolute/path/to/server/directory",
"run",
"main.py"
],
"env": {
"EMAIL_USER": "Email account username",
"EMAIL_PASS": "Email account password",
"POP3_SERVER": "POP3 Server Address",
"POP3_PORT": "POP3 Server Port Number",
"SMTP_SERVER": "SMTP Server Address",
"SMTP_PORT": "SMTP Server Port Number"
}
}
}Email MCP
Email MCP is a simple Model Context Protocol (MCP) server that adds email functionality to an AI agent - both POP3 and SMTP.
Configuration allows the registration of the POP3 and SMTP details for an email account that can be used for the purpose of email.
Tools
The following tools are accessible by the attached LLM:
pollEmails() Returns the message ID and headers of all the emails presently stored in the slected mailbox. Function has no inputs and returns a list of dict objects.
getEmailsById(ids: list) Returns the message ID and message body of all the emails called. Only input is an ID list of all the required messages. Function returns a list of dict objects.
deleteEmailsById(ids: list) Deletes a list of emails currenly in the inbox based on ID. Note that deleting any emails invalidates the current order of IDs - as such it is best to prompt the model to carry this action at the end. Function returns nothing.
sendTextEmail(fromAddress: str, toAddresses: list, subject: str, body: str) Sends a plain text formatted email via SMTP. Inputs are (in order); outgoing email address, destination addresses, subject text, body text of the email content. Function returns nothing.
- sendHtmlEmail(fromAddress: str, toAddresses: list, subject: str, body: str) Sends a HTML formatted email via SMTP. Inputs are (in order); outgoing email address, destination addresses, subject text, HTML formatted text of the email content. Function returns nothing.
Installation
Installation to _Claude Desktop_ requires the addition of the following to the developer config file:
{
"mcpServers": {
"mcp_email": {
"command": "uv",
"args": [
"--directory",
"/Absolute/path/to/server/directory",
"run",
"main.py"
],
"env": {
"EMAIL_USER": "Email account username",
"EMAIL_PASS": "Email account password",
"POP3_SERVER": "POP3 Server Address",
"POP3_PORT": "POP3 Server Port Number",
"SMTP_SERVER": "SMTP Server Address",
"SMTP_PORT": "SMTP Server Port Number"
}
}
}
}
Please Note: The second argument should be the absolute path to the MCP_EMAIL folder. For windows users it is also assumed that Python is already set up in your Path variable. For Windows installations, the backslashes should be escaped.
Finally the environment variables are should be included so as to be used to receive and send emails via POP3 and SMTP.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
