by Shy2593666979
Send emails with multiple recipients, support attachments, and search for files in a specified directory using secure SMTP via an MCP server.
MCP Email Server provides an MCP‑based interface that allows large language models to compose and dispatch emails, attach files, and locate attachment files in a given folder through pattern matching.
pip install pydantic python-dotenv
email.json configuration file that maps email domains to their SMTP servers and ports.SENDER (the email address) and PASSWORD (app‑specific password or SMTP password).python -m mcp_email_server --dir /path/to/attachment/directory
mcpServers.email with the appropriate command and arguments.Q: Do I need an app‑specific password for Gmail? A: Yes, Gmail requires an app password or OAuth token for third‑party SMTP access.
Q: Which attachment types are allowed? A: Documents (doc, docx, pdf, etc.), archives (zip, rar, 7z), text files (txt, csv, json), images (jpg, png, gif), and markdown files.
Q: How do I change the SMTP server for a custom domain?
A: Add an entry to email.json with the domain suffix, server address, and port.
Q: Can I run the server in a virtual environment? A: Absolutely; just activate the environment before installing dependencies and launching the server.
A Model Context Protocol server that provides email functionality. This server enables LLMs to compose and send emails, as well as search for attachments within specified directories.
send_email - Sends emails based on the provided subject, body, and receiver.
receiver (array of strings, required): List of recipient email addressesbody (string, required): The main content of the emailsubject (string, required): The subject line of the emailattachments (array of strings or string, optional): Email attachments (filenames)search_attachments - Searches for files in a specified directory that match a given pattern.
pattern (string, required): The text pattern to search for in file namessend_email
receiver (required): The list of recipient email addressesbody (required): The main content of the emailsubject (required): The subject line of the emailattachments (optional): Email attachmentssearch_attachments
pattern (required): The text pattern to search for in file namesInstall the required dependencies:
pip install pydantic python-dotenv
An email.json file with SMTP server configurations:
[
{
"domain": "@gmail.com",
"server": "smtp.gmail.com",
"port": 587
},
{
"domain": "@outlook.com",
"server": "smtp.office365.com",
"port": 587
},
{
"domain": "@yahoo.com",
"server": "smtp.mail.yahoo.com",
"port": 587
}
]
Start the MCP Email Server with:
python -m mcp_email_server (--dir /path/to/attachment/directory)
Add to your Claude settings:
{
"mcpServers": {
"email": {
"command": "D:\\conda\\envs\\mcp\\python.exe",
"args": [
"C:\\Users\\YourUserName\\Desktop\\servers\\src\\email\\src\\mcp_server_email",
"--dir",
"C:\\Users\\YourUserName\\Desktop"
],
"env": {
"SENDER": "2593666979q@gmail.com",
"PASSWORD": "tuogk......."
}
}
}
}
{
"mcpServers": {
"email": {
"command": "uv",
"args": [
"~\\servers\\src\\email\\src\\mcp_server_email",
"--dir",
"C:\\Users\\YourUserName\\Desktop"
],
"env": {
"SENDER": "2593666979q@gmail.com",
"PASSWORD": "tuogk......."
}
}
}
}
The server supports the following attachment file types:
{
"receiver": ["recipient@example.com"],
"subject": "Test Email from MCP Server",
"body": "This is a test email sent via the MCP Email Server.",
"attachments": ["document.pdf", "image.jpg"]
}
{
"pattern": "report"
}
We encourage contributions to help expand and improve the MCP Email Server. Whether you want to add new tools, enhance existing functionality, or improve documentation, your input is valuable.
For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers
Pull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make the MCP Email Server even more powerful and useful.
MCP Email Server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by activepieces
A self‑hosted, open‑source platform that provides a no‑code builder for creating, versioning, and running AI‑driven automation workflows. Pieces are TypeScript‑based plugins that become MCP servers, allowing direct consumption by large language models.
by Skyvern-AI
Automates browser‑based workflows by leveraging large language models and computer‑vision techniques, turning natural‑language prompts into fully functional web interactions without writing custom scripts.
by ahujasid
Enables Claude AI to control Blender for prompt‑assisted 3D modeling, scene creation, and manipulation via a socket‑based Model Context Protocol server.
by PipedreamHQ
Connect APIs quickly with a free, hosted integration platform that enables event‑driven automations across 1,000+ services and supports custom code in Node.js, Python, Go, or Bash.
by elie222
Organizes email inbox, drafts replies in the user's tone, tracks follow‑ups, and provides analytics to achieve inbox zero quickly.
by grab
Enables Cursor AI to read and programmatically modify Figma designs through a Model Context Protocol integration.
by CursorTouch
Enables AI agents to control the Windows operating system, performing file navigation, application launching, UI interaction, QA testing, and other automation tasks through a lightweight server.
by ahujasid
Enables Claude AI to control Ableton Live in real time, allowing AI‑driven creation, editing, and playback of tracks, clips, instruments, and effects through a socket‑based server.
by leonardsellem
Provides tools and resources to enable AI assistants to manage and execute n8n workflows via natural language commands.