Skip to main content
Glama
Sign In
enesjakozh

MCP Email Server

by Shy2593666979
GitHub
Python
MIT License
22
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Allows sending emails through Gmail's SMTP server with support for multiple recipients and file attachments.

  • Supports sending emails with XML files as attachments.

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:

pip install pydantic python-dotenv

Email Configuration

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 } ]

Usage

Running the Server

Start the MCP Email Server with:

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

Configure for Claude.app

Add to your Claude settings:

Conda
{ "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
{ "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

{ "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

{ "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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that enables LLMs to compose and send emails with attachments, as well as search for files in specified directories that match given patterns.

  1. Features
    1. Available Tools
    2. Prompts
  2. Installation
    1. Using pip
    2. Email Configuration
  3. Usage
    1. Running the Server
    2. Configure for Claude.app
  4. Security Notes
    1. Supported File Types
      1. Example Usage
        1. Sending an Email
        2. Searching for Attachments
      2. Contributing
        1. License

          Related MCP Servers

          • MCP Salesforce Connector

            smn2gnt
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that enables LLMs to interact with Salesforce data through SOQL queries, SOSL searches, and various API operations including record management.
            Last updated -
            10
            53
            Python
            MIT License

          • MCP Ethers Wallet

            crazyrabbitLTC
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
            Last updated -
            31
            323
            2
            TypeScript
            MIT License

          • Unstructured Document Processor MCP

            MKhalusova
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables LLMs to extract and use content from unstructured documents across a wide variety of file formats.
            Last updated -
            2
            Python
            • Apple

          • MCP URL Fetcher

            nathanonn
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables LLMs to fetch and process web content in multiple formats (HTML, JSON, Markdown, text) with automatic format detection.
            Last updated -
            TypeScript
            • Apple

          View all related MCP servers

          Appeared in Searches

          ID: 6q0abxepu2