Email

Email

MCP Email Server enables LLMs to compose and send emails with attachments.

62
Stars
15
Forks
0
Releases

Overview

The MCP Email Server is a Model Context Protocol (MCP) server that provides email functionality for LLM-driven workflows. It enables LLMs to compose and dispatch emails to multiple recipients, with optional attachments, and to search for matching attachments within configured directories. The server transmits messages securely via SMTP and supports common providers through an email.json configuration that maps domains to SMTP servers and ports (e.g., Gmail, Outlook, Yahoo). It exposes two tools: send_email (requires receiver, body, subject, and optional attachments) and search_attachments (requires a pattern to locate files). Run the server with the command: python -m mcp_email_server --dir /path/to/attachment/directory. For Claude.app integration, guidance is provided to configure via Conda or UV, setting environment variables SENDER and PASSWORD. Attachments are restricted to a security-conscious set of file types (documents, archives, text, images, and md). Example usage demonstrates JSON payloads for sending emails and searching attachments. Dependencies include pip install pydantic and python-dotenv. The server supports secure transmission and provides a practical means to upload attachments along with email content within MCP-enabled apps.

Details

Owner
Shy2593666979
Language
Python
License
MIT License
Updated
2025-12-07

Features

Send emails with multiple recipients

The server can compose and send emails to multiple recipients, including optional attachments.

Attachment support

Emails can include attachments from supported file types; attachment support is provided via the send_email tool.

Search for attachments

A tool to search for files in a directory that match a given pattern.

Secure SMTP transmission

Emails are transmitted securely using SMTP with options for TLS on common ports.

Audience

DevelopersDevelopers integrating email sending into LLM-powered workflows and automation pipelines.
IntegratorsIntegrators configuring MCP Email Server in applications to manage email dispatch with attachments.
Claude.app usersConfigure Claude.app to run the MCP Email Server and manage emails via SMTP with directory attachments.

Tags

emailsmtpattachmentsattachment-searchllmmcpclaude-apppython