Email MCP Server
About
A simple mcp server that lets your AI agent send emails and attach files through SMTP.
Details
- License
- MIT license
Explore
Send emails with full control:
- Send to multiple people with CC/BCC
- Add file attachments
- Use HTML formatting
- Override SMTP settings per email
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Email MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Test your email settings before sending important emails.
curl -LsSf https://astral.sh/uv/install.sh | sh
cd email-mcp-server
uv sync
uv run python test_email.py
Add this to your Claude Desktop configuration or Cursor file:
{
"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: Change the directory path to match your actual installation location.
| Variable | Description | Example |
|----------|-------------|---------|
| SMTP_HOST | Your email server | smtp.gmail.com |
| SMTP_PORT | Server port | 587 |
| SMTP_SECURE | Use SSL (true/false) | false |
| SMTP_USER | Your username | [email protected] |
| SMTP_FROM | Sender address | [email protected] |
| SMTP_PASS | Your password | your-password |
- Make sure all environment variables are set in the Claude Desktop config
- Check that the directory path is correct and absolute
- Restart Claude Desktop after making changes
- For Gmail/Yahoo: Use app passwords, not regular passwords
- Enable 2-Factor Authentication first
- Double-check username and password
uv run python test_email.py
Test your email settings before sending important emails.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"email mcp server": {
"email-mcp-server-egyptianego17": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"email-mcp-server-egyptianego17": {
"command": "uv",
"args": [
"sync"
]
}
}This MCP (Model Context Protocol) server lets your AI assistant send emails for you.
What Can It Do?
Your AI assistant can:
- Send both plain text and HTML emails
- Attach files and documents
- Send to multiple people with CC/BCC
- Check if your email setup works
Available Tools
send_email - Simple Email Sending
Send emails quickly using your environment configuration:
- Just specify recipient, subject, and body
- Automatically uses your configured SMTP settings
- Perfect for quick messages
send_custom_email - Advanced Email Features
Send emails with full control:
- Send to multiple people with CC/BCC
- Add file attachments
- Use HTML formatting
- Override SMTP settings per email
test_smtp_connection_tool - Check Setup
Test your email settings before sending important emails.
Getting Started
1. Install Required Software
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
