# Mcp Server Email

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-shy2593666979-mcp-server-email`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Shy2593666979](https://agentstack.voostack.com/s/shy2593666979)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Shy2593666979](https://github.com/Shy2593666979)
- **Source:** https://github.com/Shy2593666979/mcp-server-email

## Install

```sh
agentstack add mcp-shy2593666979-mcp-server-email
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Email 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.

## Features

- Send emails with multiple recipients
- Support for email attachments
- Search for files in directories based on pattern matching
- Secure email transmission using SMTP

### Available Tools

- `send_email` - Sends emails based on the provided subject, body, and receiver.
  - `receiver` (array of strings, required): List of recipient email addresses
  - `body` (string, required): The main content of the email
  - `subject` (string, required): The subject line of the email
  - `attachments` (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 names

### Prompts

- **send_email**
  - Send an email with optional attachments
  - Arguments:
    - `receiver` (required): The list of recipient email addresses
    - `body` (required): The main content of the email
    - `subject` (required): The subject line of the email
    - `attachments` (optional): Email attachments

- **search_attachments**
  - Search for files matching a pattern
  - Arguments:
    - `pattern` (required): The text pattern to search for in file names

## Installation

### Using pip

Install the required dependencies:

```bash
pip install pydantic python-dotenv
```

### Email Configuration

An `email.json` file with SMTP server configurations:

```json
[
  {
    "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
  }
]
```

## Usage

### Running the Server

Start the MCP Email Server with:

```bash
python -m mcp_email_server (--dir /path/to/attachment/directory)
```

### Configure for Claude.app

Add to your Claude settings:

#### Conda
```json
{
  "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......."
      }
    }
  }
}
```

#### UV
```json
{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}
```

## Security Notes

- For Gmail and other services, you may need to use an app-specific password
- The server supports a limited set of attachment file types for security reasons

## Supported File Types

The server supports the following attachment file types:

- 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
- Other: md

## Example Usage

### Sending an Email

```json
{
  "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"]
}
```

### Searching for Attachments

```json
{
  "pattern": "report"
}
```

## Contributing

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.

## License

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.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Shy2593666979](https://github.com/Shy2593666979)
- **Source:** [Shy2593666979/mcp-server-email](https://github.com/Shy2593666979/mcp-server-email)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shy2593666979-mcp-server-email
- Seller: https://agentstack.voostack.com/s/shy2593666979
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.