mcp-server-email

nezzeur/mcp-server-email

3.1

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

A simple MCP server for sending emails via SMTP.

Tools
1
Resources
0
Prompts
0

📬 MCP Email Server — Python SMTP Tool

Un serveur MCP (Model Context Protocol) simple permettant d'envoyer des e-mails via SMTP (Gmail ou autre).

Il expose une tool MCP (send_email), ainsi qu'une resource exposant les informations du serveur.

✨ Fonctionnalités

  • Envoi d'e-mails via SMTP (librairie standard smtplib).
  • Validation des adresses avec email_validator.
  • Interface MCP simplifiée grâce à fastmcp.
  • Ressource d'information sur le serveur (info://server).
  • Code clair et compatible avec Claude Desktop, n8n MCP, etc.

📦 Installation

1. Cloner le dépôt

git clone https://github.com/nezzeur/mcp-server-email.git
cd mcp-server-email

2. Créer et activer un environnement virtuel

Windows (PowerShell) :

python -m venv .venv
.venv\Scripts\activate

Mac / Linux :

python3 -m venv .venv
source .venv/bin/activate

3. Installer les dépendances

Utilisez uv ou pip pour installer les librairies requises :

uv pip install fastmcp email_validator

🔧 Configuration SMTP

Éditez le haut du fichier main.py pour y insérer vos identifiants :

SMTP_SERVER = "smtp.gmail.com"
SMTP_PORT = 587
SENDER_EMAIL = "votre_email@gmail.com"
SENDER_PASSWORD = "votre_mot_de_passe"

Pour Gmail 🔐

Google ne permet plus l'utilisation des "less secure apps" avec votre mot de passe habituel. Vous devez utiliser un Mot de passe d'application.

  1. Activez la validation en deux étapes sur votre compte Google.
  2. Créez un mot de passe d'application ici : https://myaccount.google.com/apppasswords
  3. Utilisez ce mot de passe (16 caractères) dans la variable SENDER_PASSWORD.

🚀 Lancer le serveur MCP

Depuis votre environnement Python actif :

python main.py

Le serveur va tourner en local. Il peut être consommé par :

  • Claude Desktop
  • n8n
  • MCP Inspector
  • Toute application compatible MCP

🛠️ Tools MCP exposés

📧 send_email(receiver, subject, content)

Permet d'envoyer un e-mail simple.

Exemple d'appel MCP (JSON) :

{
  "receiver": "test@example.com",
  "subject": "Hello World",
  "content": "This is a test email."
}

Réponse possible :

Email sent successfully to test@example.com

📚 Resources exposées

info://server

Retourne les métadonnées du serveur.

Retourne (JSON) :

{
  "name": "email-sender",
  "version": "1.0.0",
  "description": "a basic mcp server with email tool",
  "tools": ["send_email"],
  "author": "Noa Peru"
}