MCP Email Server 376

🚀 MCP Email Server

A Model Context Protocol (MCP) server that provides email functionality. This server enables Large Language Models (LLMs) to compose and send emails, as well as search for attachments in a specified directory.

🚀 Quick Start

The MCP Email Server is a powerful tool that allows LLMs to handle email - related tasks. It supports multiple recipients, attachment handling, and file searching in a specified directory.

✨ Features

• Support for sending emails to multiple recipients.
• Attachment support functionality.
• Search for files in a specified directory based on pattern matching.
• Secure email transmission using SMTP.

Available Tools

• send_email - Send an email based on the provided subject, body, and recipients.

  • receiver (array of strings, required): List of recipient email addresses.
  • body (string, required): Main content of the email.
  • subject (string, required): Subject line of the email.
  • attachments (string or array of strings, optional): Email attachments (file names).

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

  • pattern (string, required): Text pattern to search for in file names.

Tips

⚠️ Important Note

• send_email

• Send an email with optional attachments.
• Parameters:
  • receiver (required): List of recipient email addresses.
  • body (required): Main content of the email.
  • subject (required): Subject line of the email.
  • attachments (optional): Email attachments.

⚠️ Important Note

• search_attachments

• Search for files that match the pattern.
• Parameters:
  • pattern (required): Text pattern to search for in file names.

📦 Installation

Using pip

Install the required dependencies:

pip install mcp-email-server

📚 Documentation

Configuration

Environment Variables

Set the following environment variables to configure the email server:

Example Configuration

In your project, you can use it as follows:

from mcp_email_server import EmailServer

server = EmailServer(
    smtp_server=os.getenv("SMTP_SERVER", "localhost"),
    smtp_port=int(os.getenv("SMTP_PORT", 25)),
    smtp_user=os.getenv("SMTP_USER"),
    smtp_password=os.getenv("SMTP_PASSWORD")
)

Usage Instructions

Sending an Email

To send an email, prepare the request in the following format:

{
    "receiver": ["recipient1@example.com", "recipient2@example.com"],
    "body": "This is the email body.",
    "subject": "Email Subject",
    "attachments": ["document.pdf", "image.jpg"]
}

Searching for Attachments

To search for attachments, prepare the request in the following format:

{
    "pattern": "report"
}

🔧 Contribution

We welcome any contributions, whether it's adding new features, enhancing existing ones, or improving the documentation. Your input is very important to us.

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

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

📄 License

The MCP Email Server is released under the MIT License. This means you are free to use, modify, and distribute the software, provided you comply with the terms and conditions of the MIT License.