IMAP MCP Server
Status: Getestet
MCP (Model Context Protocol) Server für IMAP Email-Operationen.
Installation
cd IMAP-MCP
pip install -e .
Konfiguration
- Kopiere
config.json.examplezuconfig.json - Trage deine IMAP-Zugangsdaten ein:
{
"imap": {
"host": "imap.example.com",
"port": 993,
"secure": true
},
"credentials": {
"username": "deine-email@example.com",
"password": "dein-app-passwort"
}
}
Verwendung
Als MCP Server starten
imap-mcp
In Claude Code einbinden
In ~/.claude/settings.json:
{
"mcpServers": {
"imap": {
"command": "python",
"args": ["-m", "imap_mcp.server"],
"cwd": "/pfad/zu/IMAP-MCP/src"
}
}
}
Funktionen (38 Tools)
Verbindung
| Funktion | Beschreibung |
|---|---|
| connect | IMAP-Verbindung aufbauen |
| authenticate | Login mit Username/Passwort |
| disconnect | Verbindung schliessen |
| auto_connect | Mit config.json Credentials verbinden |
Mailboxen
| Funktion | Beschreibung |
|---|---|
| list_mailboxes | Alle Ordner auflisten |
| select_mailbox | Ordner oeffnen |
| create_mailbox | Neuen Ordner erstellen |
| get_mailbox_status | Status (Anzahl, Ungelesen, etc.) |
Emails lesen
| Funktion | Beschreibung |
|---|---|
| fetch_emails | Emails abrufen mit Filtern |
| get_email | Komplette Email per UID |
| get_email_headers | Nur Header (schneller) |
| get_email_body | Body (text/html) |
| get_attachments | Anhaenge auflisten |
| download_attachment | Anhang herunterladen (base64) |
| get_thread | Email-Thread/Konversation |
Suche
| Funktion | Beschreibung |
|---|---|
| search_emails | Freie Suche (IMAP SEARCH) |
| search_by_sender | Nach Absender |
| search_by_subject | Nach Betreff |
| search_by_date | Nach Datum |
| search_unread | Alle ungelesenen |
| search_flagged | Alle markierten |
Aktionen
| Funktion | Beschreibung |
|---|---|
| mark_read | Als gelesen markieren |
| mark_unread | Als ungelesen markieren |
| flag_email | Flag hinzufuegen |
| unflag_email | Flag entfernen |
| move_email | In anderen Ordner verschieben |
| copy_email | In anderen Ordner kopieren |
| archive_email | Archivieren |
| save_draft | Entwurf speichern |
Statistiken
| Funktion | Beschreibung |
|---|---|
| get_unread_count | Anzahl ungelesener Emails |
| get_total_count | Gesamtanzahl |
Cache & Watch
| Funktion | Beschreibung |
|---|---|
| get_cached_overview | Gecachte Uebersicht |
| refresh_cache | Cache aktualisieren |
| start_watch | IDLE Watch starten |
| stop_watch | IDLE Watch stoppen |
| idle_watch | Einzelne Mailbox beobachten |
Auto-Archive
| Funktion | Beschreibung |
|---|---|
| get_auto_archive_list | Auto-Archive Sender auflisten |
| add_auto_archive_sender | Sender hinzufuegen |
| remove_auto_archive_sender | Sender entfernen |
| reload_auto_archive | Config neu laden |
Lizenz
MIT