mcp-auto-mail

emirhannavdar/mcp-auto-mail

3.2

If you are the rightful owner of mcp-auto-mail and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A lightweight Python implementation of a JSON-RPC MCP server and client for remote file operations with email notifications.

MCP Server & Client with Email Notifications

A lightweight Python implementation of a JSON-RPC MCP server and client for remote file operations such as reading, writing, and listing directory contents. The server supports automatic email notifications with file content or attachments after writing files. A simple Tkinter GUI is included for user-friendly interaction.

Features

  • JSON-RPC 2.0 based server using Flask
  • Remote methods:
    • say_hello
    • list_files_in_dir
    • read_file
    • write_file with automatic email notification (content or attachment)
  • Simple Python client and Tkinter GUI for easy testing
  • Easily extensible for additional methods

Requirements

  • Python 3.x
  • Flask (pip install flask)
  • Requests (pip install requests)
  • SMTP email account with app-specific password (e.g. Gmail)

Setup & Usage

  1. Clone the repository:

    git clone <repository_url>
cd <repository_folder>

  2. Configure SMTP email settings in mcp_server.py: SMTP_SERVER = "smtp.gmail.com" SMTP_PORT = 587 SENDER_EMAIL = "your_email@gmail.com" SENDER_PASSWORD = "your_app_password" RECIPIENT_EMAIL = "recipient_email@gmail.com"

  3. Run the MCP server: python mcp_server.py

  4. Run the client or GUI: Client: python mcp_client.py

    GUI: python mcp_gui.py

  5. Use the client or GUI to call remote methods. Writing a file will trigger an email notification with the file content or attachment.

Notes Ensure your email account supports SMTP access and use app-specific passwords if using Gmail with 2FA.

Check spam folder if email notifications do not appear.

Extend the MCP server by adding new JSON-RPC methods as needed.