MCP Server Smtp

🚀 SMTP Email MCP Server

An MCP (Model Context Protocol) server that offers email sending capabilities, suitable for Claude and other MCP-compatible AI assistants.

✨ Features

• Multiple SMTP Configurations: Configure and manage multiple SMTP servers.
• Email Templates: Create, update, and use reusable email templates.
• Bulk Email Sending: Send emails to multiple recipients, supporting batch processing and rate limiting.
• HTML Support: Full HTML support for rich email content.
• Logging: Comprehensive logging of all email activities.
• Template Variables: Use template variables for dynamic content.

📦 Installation

# Clone the repository
git clone https://github.com/samihalawa/mcp-server-smtp.git
cd mcp-server-smtp

# Install dependencies
npm install

# Build the server
npm run build

💻 Usage Examples

Basic Usage

Start the Server

npm start

Configuration

Add the server to your MCP configuration:

{
  "servers": {
    "smtp-email-server": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-server-smtp/build/index.js"],
      "enabled": true,
      "port": 3007,
      "environment": {
        "NODE_PATH": "/path/to/node_modules",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Available Tools

send-email

Send an email to one or more recipients.

Parameters:

• to: An array of recipients containing email addresses and optional names.
• subject: The subject of the email.
• body: The body of the email (supports HTML).
• from: (Optional) The sender's email address and name.
• cc: (Optional) Carbon copy recipients.
• bcc: (Optional) Blind carbon copy recipients.
• templateId: (Optional) The ID of the template to use.
• templateData: (Optional) Data to pass to the template.

Example:

send-email(
  to: [{ email: "recipient@example.com", name: "John Doe" }],
  subject: "This is a test email",
  body: "<p>This is a test email.</p>",
  from: { email: "sender@example.com", name: "Sender Name" }
)

send-bulk-emails

Send a large number of emails.

Parameters:

• recipients: An array of recipients containing email addresses and optional names.
• subject: The subject of the email.
• body: The body of the email (supports HTML).
• batchSize: The number of emails to send per batch.
• delayBetweenBatches: The delay between batches in milliseconds.

Example:

send-bulk-emails(
  recipients: [
    { email: "user1@example.com", name: "User 1" },
    { email: "user2@example.com", name: "User 2" }
  ],
  subject: "Important Announcement",
  body: "<p>This is an important announcement.</p>",
  batchSize: 10,
  delayBetweenBatches: 1000
)

Advanced Usage

Example 1: Configure an SMTP Server

# Configure an SMTP server
config smtp {
    host = "smtp.example.com"
    port = 587
    secure = false
    authentication {
        username = "your-email@example.com"
        password = "your-app-password"
    }
}

Example 2: Create an Email Template

# Create a welcome email template
template welcome-email {
    subject = "Welcome to {{company}}!"
    body = "<h1>Hello, {{name}}!</h1><p>Welcome to {{company}}!</p>"
}

Example 3: Send a Personalized Email

# Send a personalized email
send-email(
    to: { email: "new-user@example.com", name: "New User" },
    templateId = "welcome-email",
    templateData = {
        name = "New User",
        company = "Example Company"
    }
)

📚 Documentation

Requirements

• Node.js 14+
• Use Nodemailer for email sending.
• Permission to access the SMTP server.

📄 License

MIT