MailMCP

MCP-Server für den Zugriff auf ein E-Mail-Postfach via IMAP/SMTP. Geschrieben in Node.js / TypeScript. Läuft als stdio-Prozess direkt auf dem Host.

Features

• Alle Ordner des Postfachs auflisten
• E-Mails in einem beliebigen Ordner auflisten (neuste zuerst)
• Vollständigen Inhalt einer E-Mail lesen (Text, HTML, Anhänge)
• E-Mails nach Betreff, Absender oder Body durchsuchen
• E-Mail in anderen Ordner verschieben
• E-Mails senden (inkl. CC, BCC, HTML, Anhänge als Base64)
• Lokale Datei direkt als E-Mail-Anhang versenden
• Konfigurierbarer INBOX-Ordner

Verfügbare Tools

Tool	Beschreibung
list_folders	Alle IMAP-Ordner auflisten
list_emails	E-Mails in einem Ordner auflisten (mit Filter: ungelesen)
get_email	Vollständige E-Mail per UID lesen
search_emails	E-Mails nach Stichwort durchsuchen
move_email	E-Mail in anderen Ordner verschieben
send_email	E-Mail senden (To, Subject, Text, optional CC/BCC/HTML/Anhänge als Base64)
send_local_file	Lokale Datei vom Host-Dateisystem als Anhang versenden
get_inbox_config	Aktuelle Serverkonfiguration anzeigen

Setup

1. Abhängigkeiten installieren & bauen

npm install
npm run build

2. Konfiguration

cp .env.example .env

Werte in .env anpassen:

Variable	Beschreibung	Standard
MAIL_HOST	IMAP-Server	–
MAIL_PORT	IMAP-Port	993
MAIL_SSL	IMAP SSL	true
MAIL_USER	E-Mail-Adresse	–
MAIL_PASSWORD	Passwort	–
MAIL_INBOX	Standard-Posteingang	INBOX
MAIL_MAX_EMAILS	Max. E-Mails pro Abfrage	50
SMTP_HOST	SMTP-Server	–
SMTP_PORT	SMTP-Port	587
SMTP_SSL	SMTP SSL (true = Port 465)	false
SMTP_FROM_NAME	Absendername	–

Die .env-Datei wird automatisch geladen — es sind keine Umgebungsvariablen im MCP-Client nötig.

MCP-Integration (mcporter / Claude / VS Code)

{
  "mcpServers": {
    "mailmcp": {
      "command": "node /pfad/zu/mailmcp/dist/server.js"
    }
  }
}

Dateistruktur

mailmcp/
├── src/
│   ├── server.ts        # MCP Server & Tool-Definitionen
│   ├── imap-client.ts   # IMAP-Verbindung & E-Mail-Parsing
│   ├── smtp-client.ts   # SMTP-Versand via nodemailer
│   └── config.ts        # Konfiguration via .env
├── package.json
├── tsconfig.json
├── .env                 # Credentials (nicht einchecken!)
├── .env.example
└── .gitignore