Email MCP

Name: Email MCP
Author: gaddobenedetti

@gaddobenedetti

Repository

About Email MCP

An MCP Server enabling POP3 and SMTP functionality for compatable AI Agents

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Email MCP?

Email MCP is a Model Context Protocol server that adds email functionality to an AI agent, supporting both POP3 (receiving) and SMTP (sending). It allows an LLM to poll, read, delete, and send emails through a configured email account.

How to use Email MCP?

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.

Key features of Email MCP

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.

Use cases of Email MCP

An AI assistant checks new emails and summarizes them for the user.
An AI agent sends automated replies or notifications in plain text.
An AI agent forwards or responds to emails using HTML formatting.
An AI assistant deletes spam or old emails after processing.
An AI workflow polls a mailbox for incoming requests and acts on them.

FAQ from Email MCP

What email protocols does Email MCP support?

It supports POP3 for receiving emails and SMTP for sending emails.

How do I configure Email MCP?

You must set environment variables for the email account username, password, POP3 server address and port, and SMTP server address and port in the env section of the MCP server configuration.

What runtime dependencies are required?

The server assumes Python is installed and in your PATH, and uses uv to run the script. On Windows, backslashes in the path must be escaped.

Are there any known limitations?

Deleting emails with deleteEmailsById invalidates the current order of email IDs, so it is recommended to perform deletions at the end of a session.

How does authentication work for Email MCP?

The email account credentials are provided via the EMAIL_USER and EMAIL_PASS environment variables, and the server uses them to authenticate with the POP3 and SMTP servers.