Email

What is mcp-server-email?

mcp-server-email is an MCP (Model Context Protocol) based email service that allows Large Language Models (LLMs) to send emails with attachments and search for files within specified directories. It supports secure SMTP transmission, multiple recipients, and pattern-matching search for attachments.

How to use mcp-server-email?

To use mcp-server-email, you first need to install the required Python dependencies (pydantic, python-dotenv). Then, configure your email settings in an email.json file with SMTP server details for your email provider (e.g., Gmail, Outlook, Yahoo). The server can be run using a Python command, optionally specifying an attachment directory. For integration with applications like Claude.app, you can configure it by providing the command, arguments, and environment variables (SENDER email and PASSWORD) in the application's settings.

Key Features of mcp-server-email

• Email Sending: Send emails with multiple recipients, subject, and body content.
• Attachment Support: Attach files to emails, with support for various document, archive, text, and image file types.
• Attachment Search: Search for files within specified directories based on pattern matching.
• Secure Transmission: Utilizes SMTP for secure email transmission.
• Broad Email Provider Compatibility: Works with major email services like Gmail, Outlook, Yahoo, QQ Mail, and NetEase 126 Mail.
• LLM Integration: Designed to be easily integrated with LLMs for automated email functionalities.

Available Tools:

• send_email: Sends emails with parameters for receiver, body, subject, and optional attachments.
• search_attachments: Searches for files matching a given pattern in a specified directory.

Use Cases of mcp-server-email

• Automated Notifications: LLMs can send automated email notifications or reports based on specific triggers or data analysis.
• Content Sharing: LLMs can share generated content or relevant documents via email with specified recipients.
• Information Retrieval: LLMs can search for and attach relevant files from a local directory to emails, facilitating information sharing.
• Customer Service Bots: Integrate into AI-powered customer service systems to send personalized email responses or follow-ups.

FAQ about mcp-server-email

• What email providers are supported? Gmail, Outlook, Yahoo, QQ Mail, and NetEase 126 Mail are explicitly supported.
• Do I need an app-specific password? For services like Gmail, you may need to use an app-specific password for security.
• What file types are supported for attachments? Documents (doc, docx, xls, xlsx, ppt, pptx, pdf), archives (zip, rar, 7z, tar, gz), text files (txt, log, csv, json, xml), images (jpg, jpeg, png, gif, bmp), and markdown (md).
• How do I configure SMTP settings? SMTP server details (domain, server, port) are configured in an email.json file.
• Can I contribute to the project? Yes, contributions are welcome for new tools, enhancements, or documentation improvements. The project is licensed under the MIT License.

MCP Email Server

A Model Context Protocol server that provides email functionality. This server enables LLMs to compose and send emails, as well as search for attachments within specified directories.

Features

• Send emails with multiple recipients
• Support for email attachments
• Search for files in directories based on pattern matching
• Secure email transmission using SMTP

Available Tools

• send_email - Sends emails based on the provided subject, body, and receiver.

  • receiver (array of strings, required): List of recipient email addresses
  • body (string, required): The main content of the email
  • subject (string, required): The subject line of the email
  • attachments (array of strings or string, optional): Email attachments (filenames)

• search_attachments - Searches for files in a specified directory that match a given pattern.

  • pattern (string, required): The text pattern to search for in file names

Prompts

• send_email

  • Send an email with optional attachments
  • Arguments:
    • receiver (required): The list of recipient email addresses
    • body (required): The main content of the email
    • subject (required): The subject line of the email
    • attachments (optional): Email attachments

• search_attachments

  • Search for files matching a pattern
  • Arguments:
    • pattern (required): The text pattern to search for in file names

Installation

Using pip

Install the required dependencies:

pip install pydantic python-dotenv

Email Configuration

An email.json file with SMTP server configurations:

[
  {
    "domain": "@gmail.com",
    "server": "smtp.gmail.com", 
    "port": 587
  },
  {
    "domain": "@outlook.com",
    "server": "smtp.office365.com",
    "port": 587
  },
  {
    "domain": "@yahoo.com",
    "server": "smtp.mail.yahoo.com",
    "port": 587
  }
]

Usage

Running the Server

Start the MCP Email Server with:

python -m mcp_email_server (--dir /path/to/attachment/directory)

Configure for Claude.app

Add to your Claude settings:

Conda

{
  "mcpServers": {
    "email": {
      "command": "D:\\conda\\envs\\mcp\\python.exe",
      "args": [
        "C:\\Users\\YourUserName\\Desktop\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

UV

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

Security Notes

• For Gmail and other services, you may need to use an app-specific password
• The server supports a limited set of attachment file types for security reasons

Supported File Types

The server supports the following attachment file types:

• Documents: doc, docx, xls, xlsx, ppt, pptx, pdf
• Archives: zip, rar, 7z, tar, gz
• Text files: txt, log, csv, json, xml
• Images: jpg, jpeg, png, gif, bmp
• Other: md

Example Usage

Sending an Email

{
  "receiver": ["recipient@example.com"],
  "subject": "Test Email from MCP Server",
  "body": "This is a test email sent via the MCP Email Server.",
  "attachments": ["document.pdf", "image.jpg"]
}

Searching for Attachments

{
  "pattern": "report"
}

Contributing

We encourage contributions to help expand and improve the MCP Email Server. Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers

Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make the MCP Email Server even more powerful and useful.

License

MCP Email Server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.