Email Server

An SMTP provider-independent email sending MCP service

Communication tools Developer tools #Email service #SMTP tool #MCP protocol Remote .TypeScript

rating : 2 points

downloads : 16

update time : 2025-04-28

What is Mailer MCP?

Mailer MCP is an email sending server that can work with any SMTP email service (such as Gmail, SendGrid, etc.). You can send emails through this service with simple configuration.

How to use Mailer MCP?

Simply configure your SMTP service information, and then you can send emails through simple commands or API calls. The service will automatically handle the complex interactions with the SMTP server.

Use cases

Suitable for various scenarios where you need to send notification emails, verification emails, marketing emails, etc. from applications. Especially suitable for projects that need to flexibly change SMTP providers.

Main features

Support for multiple SMTP providersSupports various SMTP services such as Gmail, SendGrid, Mailgun, etc. You can switch with simple configuration.

Simple email sendingYou can send emails through simple API calls without dealing with the complex details of the SMTP protocol.

Configuration testing toolBuilt-in testing function to quickly verify whether the SMTP configuration is correct.

Secure connectionSupports TLS encrypted connection to ensure the security of email transmission.

Advantages and limitations

Advantages

No need to bind to a specific email service provider, you can switch freely

Simplify the email sending process and reduce development complexity

Built-in error handling and log recording for easy troubleshooting

Support TypeScript and provide good type safety

Limitations

You need to configure the SMTP service yourself

No email template management function is provided

Additional development is required for advanced email functions (such as attachments)

How to use

Install the service

Clone the repository and install dependencies

Configure SMTP

Set environment variables to configure your SMTP service

Build the project

Compile TypeScript code

Start the service

Add the service to your MCP configuration and start it

Usage examples

Send a welcome emailAutomatically send a welcome email after a new user registers

Send a password reset emailSend an email containing a reset link when the user requests to reset the password

Frequently Asked Questions

Do I need to have my own SMTP server?

Are there any restrictions on sending emails?

How do I know if the email was sent successfully?

Does it support sending attachments?

Related resources

SMTP service comparison

Function comparison and prices of various SMTP services

GitHub repository

Project source code and issue tracking

Best practices for email sending

A guide on how to improve email delivery rates

🚀 Mailer MCP

A Model Context Protocol (MCP) server for sending emails. This server is designed to be completely independent of SMTP providers, allowing you to use any SMTP relay service (Gmail, SendGrid, Mailgun, SMTP2Go, etc.) by simply configuring the corresponding environment variables. The server provides tools to send emails via SMTP using environment variable configuration.

🚀 Quick Start

The Mailer MCP is a versatile server that enables seamless email sending with various SMTP providers.

✨ Features

Send emails to specified recipients.
Test the email functionality.
Configure via environment variables.
Implement proper error handling and logging.
Utilize TypeScript for type safety.

📦 Installation

Clone the repository:

git clone https://github.com/yourusername/mailer-mcp.git
cd mailer-mcp

Install dependencies:

npm install

Build the project:

npm run build

📚 Documentation

Configuration

The server requires the following environment variables to be set in the MCP configuration:

Property	Details	Example
`SMTP_HOST`	SMTP server hostname	smtp.example.com
`SMTP_PORT`	SMTP server port	587
`SMTP_USER`	SMTP username	user@example.com
`SMTP_PASSWORD`	SMTP password	password123
`EMAIL_FROM`	Sender's email address	sender@example.com

Optional environment variables:

Property	Details	Default Value
`SMTP_SECURE`	Use a secure connection (TLS)	false
`SMTP_REJECT_UNAUTHORIZED`	Reject unauthorized TLS certificates	true
`SMTP_TIMEOUT`	Connection timeout in milliseconds	10000

MCP Configuration

Add the following content to your Cline MCP settings configuration file:

"email-server": {
  "autoApprove": [],
  "disabled": false,
  "timeout": 60,
  "command": "node",
  "args": [
    "path/to/mailer-mcp/dist/index.js"
  ],
  "env": {
    "SMTP_HOST": "smtp.example.com",
    "SMTP_PORT": "587",
    "SMTP_USER": "user@example.com",
    "SMTP_PASSWORD": "password123",
    "EMAIL_FROM": "sender@example.com"
  },
  "transportType": "stdio"
}

Available Tools

send_email

Send an email to the specified recipient.

Parameters:

recipient (string, required): Recipient's email address.
body (string, required): Email body content.

Example:

{
  "recipient": "recipient@example.com",
  "body": "Hello, this is a test email from the MCP server."
}

test_email

Send a test email to verify the configuration.

Parameters: None

💻 Usage Examples

Basic Usage

To send an email, you can use the send_email tool as shown in the example above.

Advanced Usage

You can further customize the email sending process by adjusting the environment variables and configuration settings according to your specific requirements.