IMAP MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAIL_EMAIL | No | Email address for the primary account. Required when using environment variable configuration. | |
| MAIL2_EMAIL | No | Email address for a second account (optional). | |
| MAIL_PASSWORD | No | Password for the primary account. Required when using environment variable configuration. | |
| MAIL2_PASSWORD | No | Password for the second account (optional). | |
| MAIL_IMAP_HOST | No | Override the automatically detected IMAP server host. | |
| MAIL_IMAP_PORT | No | IMAP port, default is 993. | |
| MAIL_SMTP_HOST | No | Override the automatically detected SMTP server host. | |
| MAIL_SMTP_PORT | No | SMTP port, default is 465. | |
| IMAP_MCP_CONFIG | No | Path to a config.json file containing account settings (alternative to environment variables). | |
| MAIL2_IMAP_HOST | No | Override IMAP server host for the second account. | |
| MAIL2_IMAP_PORT | No | IMAP port for the second account, default 993. | |
| MAIL2_SMTP_HOST | No | Override SMTP server host for the second account. | |
| MAIL2_SMTP_PORT | No | SMTP port for the second account, default 465. | |
| MAIL_ALLOW_SEND | No | Set to 'true' to enable sending emails. Default is 'false' (read-only). | |
| MAIL2_ALLOW_SEND | No | Set to 'true' to enable sending for the second account. | |
| MAIL_DISPLAY_NAME | No | Sender name used in the From header. | |
| MAIL_DOWNLOAD_DIR | No | Directory where attachments are saved, default is ~/Downloads. | |
| MAIL2_DISPLAY_NAME | No | Sender name for the second account. | |
| MAIL_AUTODETECT_ONLINE | No | Set to 'false' to disable MX and online server auto-detection. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mail_list_accountsA | Listet die konfigurierten Mail-Accounts mit Servern und Sende-Berechtigung auf. Passwörter werden nie ausgegeben. |
| mail_test_connectionA | Prüft IMAP-Login und SMTP-Login eines Accounts und meldet beide Ergebnisse einzeln. |
| mail_detect_providerA | Ermittelt zu einer beliebigen E-Mail-Adresse die passenden IMAP- und SMTP-Einstellungen, ohne sich anzumelden. Nützlich, wenn jemand seinen Anbieter nicht kennt oder die automatische Erkennung danebenlag. Es wird kein Passwort benötigt und keine Verbindung zum Postfach aufgebaut. |
| mail_list_mailboxesA | Listet alle IMAP-Ordner eines Accounts inkl. Sonderrollen (Gesendet, Entwürfe, Papierkorb, Spam). |
| mail_searchA | Durchsucht einen IMAP-Ordner und gibt Kopfdaten (UID, Datum, Absender, Betreff, Flags) der neuesten Treffer zurück. Ohne Filter kommen die neuesten Nachrichten des Ordners. Die UIDs aus dem Ergebnis sind die Eingabe für mail_read. |
| mail_readA | Liest eine Nachricht per UID vollständig: Kopfzeilen, Text und Liste der Anhänge. HTML-Mails werden auf Text reduziert, sofern kein Textteil vorhanden ist. |
| mail_get_rawB | Gibt die vollständige RFC822-Quelle einer Nachricht zurück - nützlich zur Analyse von Kopfzeilen, SPF/DKIM oder Weiterleitungen. |
| mail_save_attachmentA | Speichert einen Anhang einer Nachricht auf der Festplatte. Zielordner ist standardmäßig der downloadDir aus der Konfiguration. |
| mail_set_flagsA | Setzt oder entfernt IMAP-Flags. Gängige Werte: "\Seen" (gelesen), "\Flagged" (markiert), "\Answered" (beantwortet). |
| mail_moveA | Verschiebt Nachrichten in einen anderen IMAP-Ordner des gleichen Accounts. |
| mail_move_to_trashA | Verschiebt Nachrichten in den Papierkorb. Löscht nie endgültig - zum endgültigen Entfernen den Papierkorb im Mailprogramm leeren. |
| mail_sendA | Versendet eine E-Mail über SMTP und legt sie im Gesendet-Ordner ab. Der Versand ist endgültig und nicht widerrufbar - vor dem Aufruf immer Empfänger, Betreff und Text vom Nutzer bestätigen lassen. |
| mail_create_draftA | Erstellt eine E-Mail und legt sie als Entwurf im IMAP-Postfach ab, ohne sie zu versenden. Der sichere Weg, wenn der Nutzer die Mail vorher im eigenen Mailprogramm prüfen will. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Every tool targets a distinct action-resource pair: account operations, mailbox listing, message retrieval, state changes, and message composition are clearly separated. Even mail_move and mail_move_to_trash are cleanly distinguished by trash-specific semantics.
All tools follow a uniform mail_<verb>_<object> pattern with clear, consistent verbs like list, test, detect, move, search, read, get, save, set, send, and create. There is no mixing of casing or verb styles.
13 tools is a well-scoped size for an email/IMAP assistant, covering account inspection, search/read, message mutations, and sending without becoming unwieldy. Each tool has a clear role and earns its place.
The set supports end-to-end email workflows: detect/test accounts, list mailboxes, search and read messages, retrieve raw sources and attachments, move/trash, set flags, and send or draft. Minor gaps like permanent deletion/expunge and mailbox creation are absent, but these appear intentional or config-external and can be worked around.