IMAP MCP Server

Status: Getestet

MCP (Model Context Protocol) Server für IMAP Email-Operationen.

Installation

cd IMAP-MCP
pip install -e .

Konfiguration

1. Kopiere config.json.example zu config.json
2. 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