MCP Email

Provides email sending via SendGrid with support for text/HTML content, templates, and attachments.

python

0

GitHub Stars

python

Language

2 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wojkos-mcp_sg_mail": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "SENDGRID_API_KEY": "YOUR_SENDGRID_API_KEY",
        "DEFAULT_FROM_NAME": "Your Name",
        "DEFAULT_FROM_EMAIL": "your-email@example.com"
      }
    }
  }
}

You have an MCP Email Server that sends emails through SendGrid. It supports basic text or HTML emails, SendGrid dynamic templates, attachments, CC/BCC, and dockerized or local stdio deployments so you can integrate email capabilities into your MCP clients or workflows.

How to use

Connect your MCP client to the email server using stdio, so you can trigger email sends from your flows. You can run the server locally using Python or deploy it with Docker. Use the available tools to send plain text or HTML emails, send with dynamic templates, or attach files to messages. Each tool handles a different email scenario and respects the default sender configuration if you do not override it in a request.

How to install

{
  "mcpServers": {
    "email": {
      "type": "stdio",
      "name": "email",
      "command": "python",
      "args": ["d:\\repos\\mcp_mail\\server.py"]
    }
  }
}

Prerequisites: Python 3.10 or higher, SendGrid account with an API key, a verified sender email in SendGrid, and Docker installed if you plan to use containerized deployment.

Local setup steps: 1) Create a virtual environment. 2) Install dependencies. 3) Prepare environment variables with your SendGrid details. 4) Run the server.

Additional sections

Configuration and environment variables: set SENDGRID_API_KEY, DEFAULT_FROM_EMAIL, and optionally DEFAULT_FROM_NAME. The DEFAULT_FROM_EMAIL must be a verified sender in SendGrid. Use DEFAULT_FROM_EMAIL as the sender when you do not provide from_email in a request.

Security notes: protect your SendGrid API key and sender email. Store credentials in a secure environment file and avoid sharing them in logs or code.

Usage notes: you can run the server locally or via Docker. When using Docker, you can supply your credentials through an environment file and run the container to expose the MCP stdio interface.

Testing and troubleshooting: verify that the API key has Mail Send permissions, ensure the sender email is verified, and confirm that file paths for attachments are accessible when using the attachment tool. If emails don’t send, check for correct from_email, template IDs, and attachment paths.

Available tools

send_email

Send a basic email with text or HTML content to a recipient.

send_email_with_template

Send an email using a SendGrid dynamic template with data to populate template variables.

send_email_with_attachments

Send an email including one or more file attachments specified by paths.