MCP Email Server

A C# Model Context Protocol (MCP) server that provides email sending capabilities using SMTP.

Prerequisites

- .NET 6.0 or later
- SMTP server credentials (e.g., Gmail, Office 365, or your own SMTP server)

Setup

1. Clone the repository

2. Set the following environment variables for SMTP configuration:

- SMTP_SERVER (e.g., smtp.gmail.com)
- SMTP_PORT (e.g., 587)
- SMTP_USERNAME (your email address)
- SMTP_PASSWORD (your app password)

Mcp Email Server can be run using the following command:

 "mcp-email-server": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", 
              "--project",
              "YOUR_PATH/smtp-dotnet-mcp-server/McpEmailServer.csproj"
            ],
      "env": {       
        "SMTP_SERVER": "localhost",
        "SMTP_PORT": "25",
        "SMTP_USERNAME": "",
        "SMTP_PASSWORD": ""
      }
    }

 "mcp-email-server": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c",               
              "YOUR_PATH/smtp-dotnet-mcp-server/McpEmailServer.exe"
            ],
      "env": {       
        "SMTP_SERVER": "localhost",
        "SMTP_PORT": "25",
        "SMTP_USERNAME": "",
        "SMTP_PASSWORD": ""
      }
    }

Gmail Setup (if using Gmail)

If you're using Gmail, you'll need to:
1. Enable 2-Step Verification in your Google Account
2. Generate an App Password:
- Go to Google Account settings
- Security
- 2-Step Verification
- App passwords
- Generate a new app password for "Mail"

Running the Server

dotnet run

Available Tools

The server provides the following MCP tools:

1. SendEmail: Sends a plain text email
- Parameters:
- to: Recipient email address
- subject: Email subject
- body: Email body text

2. SendHtmlEmail: Sends an HTML email
- Parameters:
- to: Recipient email address
- subject: Email subject
- htmlBody: HTML content for the email body

Features

- MCP server implementation with stdio transport
- SMTP email sending capabilities
- Support for both plain text and HTML emails
- Dependency injection for SMTP client and settings
- Configurable through appsettings.json
- Proper error handling and logging

Security Notes

- Never commit your email credentials to source control
- The appsettings.json file should be added to .gitignore
- Use app passwords instead of your main password when possible
- Consider using environment variables or a secure configuration management system in production