Skip to main content
Glama
MCP Email

MCP Email

MCP Email

MCP Email 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/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"
            }
        }
    }
}

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.

Available Tools

5 tools
deleteEmailsByIdB

Deletes a list of emails currenly in the inbox based on ID. Note that deleting any emails invalidates the current order of IDs.

Args: ids: A list of integer based message IDs

Inputs: ids (required).

getEmailsByIdC

Returms a list of emails currenly in the inbox based on ID. Result is a list of dict objects representing the selected emails.

Args: ids: A list of integer based message IDs

Inputs: ids (required).

pollEmailsB

Returms a list of all emails currenly in the inbox. Result is a list of dict objects representing the email in the current inbox, returning only a subset of the email data (e.g. subject, to address, from adresses) and without returning the message body.

Inputs: no named parameters.

sendHtmlEmailB

Sends an email in HTML format. No result is returned.

Args: fromAddress: String. The Originating address. toAddresses: List of strings. The destination addresses. subject: String. The subject line. body: String. The message body.

Inputs: body (required), subject (required), fromAddress (required), toAddresses (required).

sendTextEmailA

Sends an email in text format. No result is returned.

Args: fromAddress: String. The Originating address. toAddresses: List of strings. The destination addresses. subject: String. The subject line. body: String. The message body. All line breaks in the string should be encoded.

Inputs: body (required), subject (required), fromAddress (required), toAddresses (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation4/5

    pollEmails lists all inbox emails (subset, no body), while getEmailsById retrieves specific emails by ID. The distinction is mostly clear, though both return lists of email objects and the full-body retrieval behavior of getEmailsById is not explicit. Delete and send tools are clearly separate.

    Naming Consistency4/5

    All tools use camelCase with a verb-first pattern (pollEmails, getEmailsById, deleteEmailsById, sendTextEmail, sendHtmlEmail). The retrieval verbs 'poll' and 'get' differ slightly, but overall naming is predictable and consistent.

    Tool Count5/5

    Five tools provide a well-scoped minimal email client covering listing, ID-based retrieval, deletion, and two sending formats. Each tool has a clear purpose and the count is appropriate for the stated scope.

    Completeness3/5

    Core create/read/delete operations are present, but update operations (e.g., mark read/unread, flag, move) and search are missing. It is also unclear whether getEmailsById returns full email bodies, leaving a potential gap for reading message content.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to read, send, and manage emails via POP3 and SMTP with TLS support.
      6
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with email accounts via IMAP and SMTP, supporting mailbox listing, email search, retrieval, sending, and management.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to send, read, and manage emails via SMTP and IMAP, with support for attachments, threads, and mailbox organization.
      16
      52 npm
      1
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables AI models to send, receive, search, and manage emails via SMTP/IMAP, including support for attachments, contacts, and advanced search.
      18
      -