Email MCP Server
@egyptianego17
A simple mcp server that lets your AI agent send emails and attach files through SMTP.
Overview
What is Email MCP Server?
This MCP (Model Context Protocol) server lets your AI assistant send emails for you. It integrates with any SMTP email server and is designed for users who want to enable their AI assistant (e.g., Claude) to send plain text, HTML, and attachment emails.
How to use Email MCP Server?
Install the uv package manager, then run uv sync to install dependencies. Configure environment variables (SMTP_HOST, SMTP_PORT, etc.) in your Claude Desktop or Cursor configuration. Use natural language prompts to trigger the three available tools: send_email (simple), send_custom_email (advanced with attachments, CC/BCC, HTML), and test_smtp_connection_tool (verify setup). Test with uv run python test_email.py or uv run main.py.
Key features of Email MCP Server
- Send plain text and HTML emails
- Attach files and documents
- Send to multiple recipients with CC and BCC
- Test SMTP connection before sending
- Override SMTP settings per email
Use cases of Email MCP Server
- Quickly send meeting reminders via AI prompts
- Send formatted HTML newsletters or updates
- Email project reports with attached documents to multiple people
- Verify email configuration before critical communications
FAQ from Email MCP Server
How do I configure Email MCP Server for Gmail?
Enable 2-Factor Authentication, generate an app password in your Google Account, then set SMTP_HOST=smtp.gmail.com, SMTP_PORT=587, SMTP_SECURE=false, and use the app password as SMTP_PASS.
How can I test if my email setup works?
Use the test_smtp_connection_tool or run uv run python test_email.py --send-real to send a real test email to yourself.
What should I do if I get "Authentication Failed"?
For Gmail or Yahoo, use an app password instead of your regular password and ensure 2-Factor Authentication is enabled. Double-check your username and password in the environment variables.
Can I send attachments with Email MCP Server?
Yes, use the send_custom_email tool to add file attachments. Attachments are not available in the simple send_email tool.
What SMTP settings are needed for other email providers?
Most providers use port 587 with SMTP_SECURE=false (STARTTLS) or port 465 with SMTP_SECURE=true (SSL). Replace the SMTP host, port, and credentials with your provider's details.
