MCP Email Server

@Shy2593666979

Basic information

About MCP Email Server

一个基于 MCP (Model Context Protocol) 的邮件服务，支持 LLM 发送带附件的电子邮件及在指定目录中搜索文件。提供安全的 SMTP 传输、多收件人支持和附件模式匹配搜索功能，适用于 Gmail、Outlook、Yahoo、QQ 邮箱和网易 126 邮箱等主流邮箱服务。

MCP Email Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-email": {
      "command": "python",
      "args": [
        "-m",
        "mcp_email_server",
        "(--dir",
        "/path/to/attachment/directory)"
      ]
    }
  }
}

MCP Email Server tools

Sends emails based on the provided subject, body, and receiver.

Searches for files in a specified directory that match a given pattern.

Overview

What is MCP Email Server?

The MCP Email Server is a Model Context Protocol server that enables LLMs to compose and send emails and search for attachments in specified directories using SMTP.

How to use MCP Email Server?

Install dependencies (pydantic, python-dotenv), create an email.json file with SMTP server configurations, set the SENDER and PASSWORD environment variables, and run the server with python -m mcp_email_server --dir /path/to/attachment/directory. Configure it in Claude.app by adding the server details to the MCP servers settings.

Key features of MCP Email Server

Send emails with multiple recipients and attachments
Search for files in directories using pattern matching
Secure email transmission via SMTP
Supports common file types for attachments (documents, archives, text, images)
Provides both tools and prompts for email and attachment operations

Use cases of MCP Email Server

An LLM assistant sending an email with attachments on behalf of a user
Automating email notifications by composing and sending messages from within a conversation
Searching a local directory for files that match a pattern before attaching them to an email
Integrating email capability into a Claude-based workflow without leaving the chat

Frequently asked questions

What dependencies are required?

The server requires `pydantic` and `python-dotenv` packages. Install them via pip.

How do I configure email credentials?

Set the `SENDER` environment variable to your email address and `PASSWORD` to your SMTP password or app-specific password. For Gmail and similar services, an app‑specific password may be required.

What file types are supported for attachments?

The server supports documents (doc, docx, xls, xlsx, ppt, pptx, pdf), archives (zip, rar, 7z, tar, gz), text files (txt, log, csv, json, xml), images (jpg, jpeg, png, gif, bmp), and other files like md.

How do I set up the SMTP server?

Create an `email.json` file in the server directory with an array of objects, each containing `domain` (e.g., `@gmail.com`), `server` (e.g., `smtp.gmail.com`), and `port` (typically 587).

Are there any security considerations?

You should use an app‑specific password for email accounts that require it. The server also restricts attachment file types to a limited list for security reasons.

Comments

More Communication MCP servers

Ghostedit

Post to Instagram, TikTok, YouTube, Threads, LinkedIn, Bluesky and Mastodon from Claude, ChatGPT or Claude Code. Every post is checked against each platform's rules before it goes out, you can see what worked, and Instag

DashaMail

MCP server for DashaMail email marketing service

Mektup-mcp

WeeCi

Mektup gives AI agents and their humans a real email mailbox, not just a one-way sending API. Through 41 MCP tools, an agent can register a domain, create a mailbox, send and receive mail, and manage threads, drafts, fol

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.