Email MCP

MCP Email

MCP Email 是一个简单的 Model Context Protocol（MCP）服务，可为 AI Agent 添加电子邮件功能，支持 POP3 和 SMTP。

通过配置，可以注册电子邮件账户的 POP3 和 SMTP 详细信息，以便用于收发电子邮件。

工具

附加的大模型可使用以下工具：

• pollEmails() 返回所选邮箱中当前存储的所有电子邮件的消息 ID 和标头。此函数不需要输入，并返回 list 类型的 dict 对象。

• getEmailsById(ids: list) 返回所有指定电子邮件的消息 ID 和正文。唯一的输入是所需消息的 ID 列表。此函数返回 list 类型的 dict 对象。

• deleteEmailsById(ids: list) 根据 ID 删除收件箱中当前的电子邮件列表。请注意，删除任何电子邮件都会使当前 ID 顺序失效，因此最好提示模型在最后执行此操作。此函数不返回任何内容。

• sendTextEmail(fromAddress: str, toAddresses: list, subject: str, body: str) 通过 SMTP 发送纯文本格式的电子邮件。输入依次为：发件邮箱地址、收件人地址、主题文本、电子邮件正文文本。此函数不返回任何内容。

• sendHtmlEmail(fromAddress: str, toAddresses: list, subject: str, body: str) 通过 SMTP 发送 HTML 格式的电子邮件。输入依次为：发件邮箱地址、收件人地址、主题文本、HTML 格式的电子邮件正文文本。此函数不返回任何内容。

安装

要安装到 Claude Desktop，请将以下内容添加到开发者配置文件中：

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

请注意： 第二个参数应为 MCP_EMAIL 文件夹的绝对路径。对于 Windows 用户，默认 Python 已添加到 Path 变量中。对于 Windows 安装，需要对反斜杠进行转义。

最后，需要设置环境变量，以便通过 POP3 和 SMTP 收发电子邮件。