IMAP-Server mit Claude einrichten

Claude Desktop kann E-Mail-Entwürfe erstellen und direkt im IMAP-Postfach ablegen – ganz ohne Azure, OAuth oder Cloud-Dienste. In diesem Beitrag zeigen wir Ihnen Schritt für Schritt, wie Sie den imap-mcp-Server von dominik1001 auf Claude Desktop unter Windows einrichten. Besonderes Augenmerk liegt auf den zahlreichen Stolpersteinen, die uns begegnet sind – vor allem mit der deutschen Sprachversion und der Windows Store-Variante von Claude Desktop.

Hinweis: Der imap-mcp-Server kann aktuell nur Entwürfe erstellen. Wenn Sie E-Mails auch lesen, durchsuchen und senden möchten, empfehlen wir unseren ausführlichen Beitrag zur Einrichtung von mcp-mail-server in Claude Desktop. Beide Server lassen sich aber auch parallel betreiben – dazu am Ende dieses Beitrags mehr.

Was ist ein MCP-Server?

MCP steht für Model Context Protocol – ein offener Standard, mit dem KI-Assistenten wie Claude auf externe Tools und Datenquellen zugreifen können. Ein MCP-Server für E-Mail gibt Claude die Fähigkeit, mit Ihrem Postfach zu interagieren. Alles läuft lokal auf Ihrem Rechner, ohne dass E-Mail-Daten an Cloud-Dienste von Drittanbietern übertragen werden.

imap-mcp vs. mcp-mail-server – welches Paket brauchen Sie?

Bevor Sie loslegen: Es gibt mehrere MCP-Pakete für E-Mail auf npm. Hier der direkte Vergleich der beiden bekanntesten:

Fazit: Wenn Sie den vollen Funktionsumfang wollen, ist mcp-mail-server die bessere Wahl. Der imap-mcp-Server hat aber seine Berechtigung, wenn Sie Entwürfe gezielt im IMAP-Entwürfe-Ordner ablegen wollen – etwa als Vorstufe, bevor Sie E-Mails manuell prüfen und absenden.

Voraussetzungen

Bevor es losgeht, benötigen Sie drei Dinge:

1. Node.js (Version 18 oder neuer) – von nodejs.org herunterladen und installieren
2. Claude Desktop – aus dem Microsoft Store oder als Standalone-Installer von claude.ai
3. IMAP-Zugangsdaten Ihres E-Mail-Providers: Host, Port (typisch: 993 mit SSL), Benutzername und Passwort

Tipp: Eine Übersicht der IMAP-Zugangsdaten gängiger deutscher Anbieter (All-Inkl, GMX, web.de, Gmail, Outlook, Ionos, Strato) finden Sie in unserem Beitrag zum mcp-mail-server.

Schritt 1: imap-mcp installieren

Öffnen Sie PowerShell und installieren Sie das Paket global:

npm install -g imap-mcp

Prüfen Sie die Installation:

npm list -g imap-mcp
Test-Path "$env:APPDATA\npm\node_modules\imap-mcp\dist\index.js"

Beide Befehle sollten imap-mcp@0.1.0 bzw. True ausgeben.

Schritt 2: Windows-Pfad-Bug fixen (KRITISCH!)

Stolperstein 1: main() wird nie aufgerufen

Der imap-mcp-Server enthält einen Windows-Pfad-Bug, der dazu führt, dass der Server zwar startet, aber nichts tut. Die main()-Funktion wird nie aufgerufen, weil ein Pfadvergleich auf Windows fehlschlägt:

// Aus index.js – dieser Vergleich schlägt auf Windows fehl:
if (import.meta.url === `file://${process.argv[1]}`) {
    main();
}

Warum? import.meta.url verwendet Forward-Slashes (file:///C:/Users/...), aber process.argv[1] enthält Windows-Backslashes (C:\Users\...). Der Vergleich ist niemals wahr – der Server startet und beendet sich sofort wieder, ohne je etwas zu tun.

Die Lösung: Wrapper-Script erstellen

Erstellen Sie eine Datei start.mjs im dist-Ordner, die main() direkt aufruft:

Set-Content "$env:APPDATA\npm\node_modules\imap-mcp\dist\start.mjs" 'import { main } from "./index.js"; main();'

Dieses Script umgeht den fehlerhaften Pfadvergleich komplett.

Schritt 3: Deutsche Ordnernamen anpassen (KRITISCH!)

Stolperstein 2: „Drafts“ existiert nicht auf deutschen Mailservern

Der imap-mcp-Server sucht den Entwürfe-Ordner unter den englischen Namen "INBOX.Drafts" und "Drafts". Auf deutschen Mailservern heißt der Ordner aber typischerweise „Entwürfe“. Ohne diese Anpassung erhalten Sie die Fehlermeldung:

Failed to open drafts folder: Mailbox doesn't exist: Drafts

Ordnernamen Ihres Servers herausfinden

Mit diesem PowerShell-Befehl können Sie die IMAP-Ordnerstruktur Ihres Mailservers abfragen. Passen Sie die Zugangsdaten an:

& "C:\Program Files\nodejs\node.exe" -e "
const Imap=require('$($env:APPDATA -replace '\\','/')/npm/node_modules/imap-mcp/node_modules/imap');
const c=new Imap({user:'DEIN_USER',password:'DEIN_PASSWORT',host:'DEIN_IMAP_HOST',port:993,tls:true,tlsOptions:{rejectUnauthorized:false}});
c.once('ready',()=>{c.getBoxes((e,b)=>{function list(o,p){for(let k in o){console.log(p+k);if(o[k].children)list(o[k].children,p+k+'.')}};list(b,'');c.end()})});
c.once('error',e=>console.error(e));c.connect()"

Typische Ausgabe eines deutschen Mailservers:

INBOX
Entwürfe
Gesendet
Papierkorb
Spam
Archiv

Die gängigsten Zuordnungen zwischen englischen und deutschen Ordnernamen:

Stolperstein 3: UTF-8-Kodierung bei Umlauten

Beim Ersetzen der Ordnernamen im Quellcode ist besondere Vorsicht geboten. Das Standard-Cmdlet Set-Content in PowerShell speichert Dateien nicht in UTF-8, was Umlaute zerstört. Aus Entwürfe wird dann Entwrfe – und der Mailserver findet den Ordner nicht.

So geht es richtig – mit expliziter UTF-8-Kodierung:

$content = [System.IO.File]::ReadAllText("$env:APPDATA\npm\node_modules\imap-mcp\dist\tools\create-draft.js")
$content = $content -replace '"INBOX\.Drafts"','"Entwürfe"' -replace '"Drafts"','"Entwürfe"'
[System.IO.File]::WriteAllText("$env:APPDATA\npm\node_modules\imap-mcp\dist\tools\create-draft.js", $content, [System.Text.Encoding]::UTF8)

⚠️ Niemals Set-Content verwenden! Immer [System.IO.File]::WriteAllText() mit expliziter UTF-8-Kodierung. Diesen Stolperstein behandeln wir auch in unserem mcp-mail-server-Beitrag – er gilt für alle MCP-Pakete gleichermaßen.

Ergebnis prüfen:

Select-String -Path "$env:APPDATA\npm\node_modules\imap-mcp\dist\tools\create-draft.js" -Pattern "openBox"

Es sollte "Entwürfe" statt "Drafts" anzeigen.

Schritt 4: Claude Desktop Config erstellen

Stolperstein 4: Zwei mögliche Config-Pfade

Claude Desktop liest die Konfiguration je nach Installationsart aus unterschiedlichen Ordnern:

Um herauszufinden, welche Version installiert ist, öffnen Sie PowerShell und führen folgenden Befehl aus:

Get-Process -Name "claude" | Select-Object Path

Enthält der Pfad WindowsApps, handelt es sich um die Store-Version. Ansonsten ist es die Standalone-Variante.

Unsere Empfehlung: Schreiben Sie die Config einfach in beide Pfade. Dann funktioniert es garantiert, egal welche Version installiert ist.

Config schreiben

Passen Sie die Zugangsdaten im folgenden PowerShell-Befehl an und führen Sie ihn aus:

$config = @'
{
  "mcpServers": {
    "imap": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\DEIN_USERNAME\\AppData\\Roaming\\npm\\node_modules\\imap-mcp\\dist\\start.mjs"],
      "env": {
        "IMAP_HOST": "DEIN_IMAP_HOST",
        "IMAP_PORT": "993",
        "IMAP_USERNAME": "DEINE_EMAIL",
        "IMAP_PASSWORD": "DEIN_PASSWORT",
        "IMAP_USE_SSL": "true"
      }
    }
  }
}
'@

# Standalone-Pfad
New-Item -ItemType Directory -Force -Path "$env:APPDATA\Claude" | Out-Null
$config | Set-Content "$env:APPDATA\Claude\claude_desktop_config.json" -Encoding UTF8

# Store-Pfad (falls vorhanden)
$storePath = "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude"
if (Test-Path "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc") {
    New-Item -ItemType Directory -Force -Path $storePath | Out-Null
    $config | Set-Content "$storePath\claude_desktop_config.json" -Encoding UTF8
}

Write-Host "Config geschrieben!" -ForegroundColor Green

Stolperstein 5: Falsche Umgebungsvariablen

Jedes MCP-Paket verwendet eigene Variablennamen. Online-Anleitungen mischen diese gerne durcheinander – wenn Sie also eine Anleitung für mcp-mail-server finden und die Variablen für imap-mcp verwenden, wird es nicht funktionieren:

Stolperstein 6: npx vs. absoluter Pfad

Viele Anleitungen empfehlen folgende Konfiguration:

"command": "npx",
"args": ["imap-mcp"]

Das kann auf Windows Probleme machen, weil npx manchmal auf eine Bestätigung wartet oder den Pfad nicht auflösen kann. Zuverlässiger ist der absolute Pfad zu node.exe und zur start.mjs:

"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\User\\AppData\\Roaming\\npm\\node_modules\\imap-mcp\\dist\\start.mjs"]

Den genauen Pfad zu node.exe finden Sie mit:

(Get-Command node).Source

Schritt 5: Claude Desktop neu starten und testen

Nach dem Speichern der Config muss Claude Desktop komplett neu gestartet werden – nicht nur das Fenster schließen, sondern den Prozess beenden.

Store-Version:

Get-Process -Name "claude" -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep 3
Start-Process "shell:AppsFolder\Claude_pzs8sxrjxfjjc!Claude"

Standalone-Version:

Get-Process -Name "Claude" -ErrorAction SilentlyContinue | Stop-Process -Force
Start-Sleep 3
Start-Process "$env:LOCALAPPDATA\AnthropicClaude\Claude.exe"

Prüfen, ob der Server läuft

1. Öffnen Sie Claude Desktop
2. Gehen Sie zu ☰ Menü → Einstellungen → Entwickler
3. Dort sollte imap mit dem grünen Status „running“ erscheinen

Stolperstein 7: Das Hammer-Symbol fehlt

Nach der Installation erwarten viele Nutzer ein Hammer-Symbol 🔨 im Chat-Eingabefeld. Das erscheint aber nicht immer automatisch. Stattdessen gehen Sie so vor:

1. Klicken Sie auf das + Symbol unten links im Chat-Eingabefeld
2. Gehen Sie zu Konnektoren
3. Stellen Sie sicher, dass „imap“ einen blauen Toggle hat (= aktiviert)

Erster Test

Starten Sie einen neuen Chat und schreiben Sie:

Erstelle einen E-Mail-Entwurf an test@test.com mit Betreff „Test“ und Text „Hallo, das ist ein Test von Claude!“

Claude ruft dann das create-draft Tool auf und legt den Entwurf im IMAP-Entwürfe-Ordner ab. Sie können ihn anschließend in Ihrem E-Mail-Programm öffnen, prüfen und manuell absenden.

Troubleshooting

Server manuell testen

Falls der Server in Claude Desktop nicht startet, können Sie ihn direkt in PowerShell testen. Setzen Sie Ihre Zugangsdaten als Umgebungsvariablen und senden Sie eine MCP-Initialisierungsnachricht:

$env:IMAP_HOST="DEIN_HOST"
$env:IMAP_PORT="993"
$env:IMAP_USERNAME="DEINE_EMAIL"
$env:IMAP_PASSWORD="DEIN_PASSWORT"
$env:IMAP_USE_SSL="true"

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"capabilities":{},"clientInfo":{"name":"test","version":"1.0"},"protocolVersion":"2024-11-05"}}' | & "C:\Program Files\nodejs\node.exe" "$env:APPDATA\npm\node_modules\imap-mcp\dist\start.mjs"

Erwartete Ausgabe: Eine JSON-Antwort mit "protocolVersion":"2024-11-05" und "serverInfo":{"name":"imap-mcp","version":"0.1.0"}. Wenn stattdessen eine Fehlermeldung erscheint, stimmen die Zugangsdaten oder der Pfad nicht.

IMAP-Verbindung testen

Test-NetConnection -ComputerName "DEIN_IMAP_HOST" -Port 993

Erwartete Ausgabe: TcpTestSucceeded : True

Logs finden

Relevante Zeilen filtern:

Select-String -Path "PFAD_ZUR_LOG" -Pattern "imap|error|fail" | Select-Object -Last 30

Häufige Fehler und Lösungen

Limitierungen von imap-mcp

Das Paket imap-mcp (v0.1.0) ist bewusst minimalistisch gehalten. Es kann E-Mail-Entwürfe erstellen und im IMAP-Entwürfe-Ordner speichern – mehr nicht. Es kann keine E-Mails lesen, keine E-Mails senden (kein SMTP), keine Ordner durchsuchen und keine Anhänge verarbeiten.

Wenn Sie den vollen Funktionsumfang benötigen – also E-Mails lesen, suchen, senden und beantworten – empfehlen wir die Einrichtung von mcp-mail-server. Dort finden Sie auch eine vollständige Übersicht aller 12 verfügbaren Tools.

Beide Server parallel betreiben

Sie können imap-mcp und mcp-mail-server gleichzeitig in Claude Desktop nutzen. Das ist sinnvoll, wenn Sie Entwürfe gezielt im IMAP-Entwürfe-Ordner ablegen UND E-Mails lesen und senden möchten. Dafür tragen Sie beide Server in die Config ein:

{
  "mcpServers": {
    "imap": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\User\\...\\imap-mcp\\dist\\start.mjs"],
      "env": {
        "IMAP_HOST": "...",
        "IMAP_PORT": "993",
        "IMAP_USERNAME": "...",
        "IMAP_PASSWORD": "...",
        "IMAP_USE_SSL": "true"
      }
    },
    "email": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\Users\\User\\...\\mcp-mail-server\\dist\\index.js"],
      "env": {
        "IMAP_HOST": "...",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "SMTP_HOST": "...",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "EMAIL_USER": "...",
        "EMAIL_PASS": "..."
      }
    }
  }
}

Beachten Sie die unterschiedlichen Variablennamen der beiden Pakete (siehe Stolperstein 5). Eine ausführliche Anleitung zur Einrichtung von mcp-mail-server finden Sie in unserem separaten Beitrag.

Sicherheitshinweise

Das Passwort steht im Klartext in der Config-Datei. Stellen Sie sicher, dass andere Nutzer Ihres Rechners keinen Zugriff darauf haben. Erwägen Sie die Nutzung eines App-Passworts statt Ihres Hauptpassworts, falls Ihr Provider das unterstützt.

Alle E-Mail-Daten bleiben lokal auf Ihrem Rechner. Es werden keine Daten an Anthropic oder andere Cloud-Dienste übertragen, abgesehen von der normalen Chat-Kommunikation mit Claude.

Zusammenfassung: Die 7 Stolpersteine

1. Windows-Pfad-Bug – main() wird nicht aufgerufen → Wrapper start.mjs erstellen
2. Deutsche Ordnernamen – Drafts existiert nicht → Entwürfe im Quellcode eintragen
3. UTF-8-Kodierung – PowerShells Set-Content zerstört Umlaute → [System.IO.File]::WriteAllText() nutzen
4. Store vs. Standalone Config-Pfad – Zwei verschiedene Orte für die gleiche Datei
5. Falsche Umgebungsvariablen – Jedes Paket hat eigene Namen (IMAP_USERNAME vs. EMAIL_USER)
6. npx-Probleme auf Windows – Besser den absoluten Pfad zu node.exe verwenden
7. Hammer-Symbol fehlt – MCP-Tools sind unter + → Konnektoren versteckt

Getestet am 22. Februar 2026 mit Claude Desktop 1.1.3963 (Microsoft Store), Node.js v24.13.1, imap-mcp 0.1.0 auf Windows 11.