Email MCP Server

What does “Email” MCP Server do?

The Email MCP Server is a simple Model Context Protocol (MCP) server that enables your AI assistant to send emails and attach files via SMTP. Acting as a bridge between AI agents and external email systems, it provides tools for basic and advanced email-sending capabilities, including HTML content, file attachments, CC/BCC support, and SMTP connection testing. This server streamlines workflows by allowing developers and AI agents to automate communication tasks, validate SMTP configurations, and manage email settings programmatically—expanding the assistant’s ability to interact with real-world messaging systems and boost productivity for development and automation scenarios.

List of Prompts

No explicit prompt templates are documented in the repository. This section is empty.

List of Resources

No explicit MCP resources are mentioned in the documentation or code. This section is empty.

List of Tools

• send_email
  Simple tool for sending plain text or HTML emails to recipients using your configured SMTP settings. Requires recipient, subject, and body.

• send_custom_email
  Advanced email-sending tool with support for CC/BCC, file attachments, HTML formatting, and the ability to override SMTP settings per email.

• test_smtp_connection_tool
  Utility tool to validate your SMTP configuration and ensure that email sending is properly set up before use.

Use Cases of this MCP Server

• Automated Email Notifications
  AI agents can send instant notifications, reminders, or status updates to users or teams by email, streamlining communication workflows.

• File and Report Distribution
  Distribute generated reports, logs, or documents as attachments to one or multiple recipients, reducing manual sharing steps.

• Team Announcements with Formatting
  Use HTML support to craft visually appealing team updates or newsletters with rich formatting and multiple recipients via CC/BCC.

• SMTP Configuration Verification
  Developers can quickly check and validate SMTP settings to avoid failed email deliveries during deployment or integration phases.

• Personalized Outreach Automation
  Automate sending personalized emails for onboarding, customer support, or follow-ups, leveraging AI to craft and deliver messages at scale.

How to set it up

Windsurf

No specific Windsurf setup instructions are provided in the repository.

Claude

1. Install Required Software

   • Install uv (Python package manager):
     curl -LsSf https://astral.sh/uv/install.sh | sh
     Restart terminal or run source ~/.bashrc

2. Install Project Dependencies

   • cd email-mcp-server
   • uv sync

3. Test the Installation

   • uv run python test_email.py
   • (Optional) Run the server: uv run main.py

4. Configure Claude Desktop

   • Edit your Claude Desktop configuration and add:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

Important: Update the directory path to match your installation.

Cursor

1. Install Required Software

   • Install uv:
     curl -LsSf https://astral.sh/uv/install.sh | sh
     Restart terminal or run source ~/.bashrc

2. Install Project Dependencies

   • cd email-mcp-server
   • uv sync

3. Test the Installation

   • uv run python test_email.py
   • (Optional) Run the server: uv run main.py

4. Configure Cursor

   • Edit your configuration file and add:

{
  "mcpServers": {
    "mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/the/app/email-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SMTP_HOST": "",
        "SMTP_PORT": "",
        "SMTP_SECURE": "",
        "SMTP_USER": "",
        "SMTP_FROM": "",
        "SMTP_PASS": ""
      }
    }
  }
}

Important: Update the directory path to match your installation.

Cline

No specific Cline setup instructions are provided in the repository.

Securing API Keys Using Environment Variables

Configure sensitive SMTP credentials via the env section in your MCP server configuration. Example:

"env": {
  "SMTP_HOST": "smtp.gmail.com",
  "SMTP_PORT": "587",
  "SMTP_SECURE": "false",
  "SMTP_USER": "your-email@gmail.com",
  "SMTP_FROM": "your-email@gmail.com",
  "SMTP_PASS": "your-app-password"
}

Store actual secrets outside the configuration file where possible.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "email-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “email-mcp” to the actual name and update the URL accordingly.

Overview

Roots support: Not mentioned

Sampling support: Not mentioned

Based on the above tables, the Email MCP Server provides robust and clear tooling for email automation, but lacks documented prompt templates, explicit MCP resources, and information on advanced protocol features like roots or sampling. Setup is straightforward for Claude and Cursor, with clear environment variable support.

Our opinion

This MCP server is straightforward and well-documented for its primary use case, but lacks more advanced MCP features and resources. It’s highly functional for email tasks but limited in extensibility and protocol depth. I’d rate it a 6/10 for basic utility and documentation, with room for improvement in feature completeness and MCP protocol coverage.

MCP Score