Email MCP

MCP Email is a simple Model Context Protocol (MCP) server that adds email functionality to an AI agent - both POP3 and SMTP.

Local serverstdio

What is the Email MCP Server?

Email MCP is an MCP project maintained in the gaddobenedetti/mcp_email repository. The maintainer describes its purpose as “MCP Email is a simple Model Context Protocol (MCP) server that adds email functionality to an AI agent - both POP3 and SMTP”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares EMAIL_USER, EMAIL_PASS, POP3_SERVER, POP3_PORT, SMTP_SERVER, SMTP_PORT. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
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.
getEmailsByIdids: 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…
deleteEmailsByIdids: 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…
sendTextEmailfromAddress: str, toAddresses: list, subject: str, body: str) Sends a plain text formatted email via SMTP. Inputs are (in order); outgoing email address…
sendHtmlEmailfromAddress: str, toAddresses: list, subject: str, body: str) Sends a HTML formatted email via SMTP. Inputs are (in order); outgoing email address, destination

How to install the Email MCP Server

{
  "mcpServers": {
    "mcp_email": {
      "command": "uv",
      "args": [
        "--directory",
        "/Absolute/path/to/server/directory/mcp_email",
        "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"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
EMAIL_USERDeclared in the maintainer’s client configuration.Check documentation
EMAIL_PASSDeclared in the maintainer’s client configuration.Check documentation
POP3_SERVERDeclared in the maintainer’s client configuration.Check documentation
POP3_PORTDeclared in the maintainer’s client configuration.Check documentation
SMTP_SERVERDeclared in the maintainer’s client configuration.Check documentation
SMTP_PORTDeclared in the maintainer’s client configuration.Check documentation