Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MailMCP show me unread emails from today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
Related MCP server: mcp-imap
Tool | Beschreibung |
| Alle IMAP-Ordner auflisten |
| E-Mails in einem Ordner auflisten (mit Filter: ungelesen) |
| Vollständige E-Mail per UID lesen |
| E-Mails nach Stichwort durchsuchen |
| E-Mail in anderen Ordner verschieben |
| E-Mail senden (To, Subject, Text, optional CC/BCC/HTML/Anhänge als Base64) |
| Lokale Datei vom Host-Dateisystem als Anhang versenden |
| Aktuelle Serverkonfiguration anzeigen |
npm install
npm run buildcp .env.example .envWerte in .env anpassen:
Variable | Beschreibung | Standard |
| IMAP-Server | – |
| IMAP-Port |
|
| IMAP SSL |
|
| E-Mail-Adresse | – |
| Passwort | – |
| Standard-Posteingang |
|
| Max. E-Mails pro Abfrage |
|
| SMTP-Server | – |
| SMTP-Port |
|
| SMTP SSL (true = Port 465) |
|
| Absendername | – |
Die .env-Datei wird automatisch geladen — es sind keine Umgebungsvariablen im MCP-Client nötig.
{
"mcpServers": {
"mailmcp": {
"command": "node /pfad/zu/mailmcp/dist/server.js"
}
}
}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
└── .gitignoreLiest den vollständigen Inhalt einer E-Mail anhand ihrer UID. Gibt Betreff, Absender, Empfänger, Datum, Text-Body, HTML-Body und Dateianhänge zurück.
Inputs: uid (required), folder.
Zeigt die aktuelle Serverkonfiguration an (Host, User, INBOX-Ordner). Passwort wird nicht zurückgegeben.
Inputs: no named parameters.
Listet E-Mails in einem Ordner auf (neuste zuerst). Gibt UID, Betreff, Absender, Datum, Lesestatus und Anhänge zurück. Standardmäßig wird der konfigurierte INBOX-Ordner verwendet.
Inputs: limit, folder, only_unread.
Listet alle verfügbaren E-Mail-Ordner auf dem IMAP-Server auf.
Inputs: no named parameters.
Verschiebt eine E-Mail anhand ihrer UID in einen anderen Ordner.
Inputs: uid (required), target_folder (required), source_folder.
Durchsucht einen Ordner nach E-Mails anhand eines Suchbegriffs.
Inputs: query (required), limit, folder, search_in.
Sendet eine E-Mail via SMTP.
Inputs: to (required), text (required), subject (required), cc, +4 more.
Liest eine lokale Datei vom Server-Dateisystem und verschickt sie als E-Mail-Anhang via SMTP. Betreff und Text-Body sind optional und werden aus dem Dateinamen abgeleitet, wenn nicht angegeben.
Inputs: to (required), file_path (required), cc, bcc, +3 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 8 tools
Each tool addresses a distinct email operation: listing folders, listing messages, reading a single message, searching, sending, moving, sending a local file, and viewing config. The only mild overlap is send_email and send_local_file, but they are clearly differentiated by attachment source and defaults.
All tools follow a consistent lowercase verb_noun pattern: list_folders, list_emails, get_email, search_emails, send_email, move_email, send_local_file, and get_inbox_config. The naming style is uniform and predictable.
Eight tools is well-scoped for an email MCP server. The set covers core email operations without unnecessary redundancy or bloat.
The core email workflow is covered: listing folders and emails, reading, searching, sending, moving, and handling local file attachments. Obvious gaps like deleting emails, marking read/unread, or creating folders are missing, but agents can still accomplish most common tasks.
Search connected email, read and manage messages, draft and send, and manage rules for new mail.
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Email for AI agents: read, search and send from your Gmail, Outlook, Yahoo, iCloud or IMAP inbox.
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
