# MailMCP

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.

## Features

- 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

## Verfügbare Tools

| Tool | Beschreibung |
|---|---|
| `list_folders` | Alle IMAP-Ordner auflisten |
| `list_emails` | E-Mails in einem Ordner auflisten (mit Filter: ungelesen) |
| `get_email` | Vollständige E-Mail per UID lesen |
| `search_emails` | E-Mails nach Stichwort durchsuchen |
| `move_email` | E-Mail in anderen Ordner verschieben |
| `send_email` | E-Mail senden (To, Subject, Text, optional CC/BCC/HTML/Anhänge als Base64) |
| `send_local_file` | Lokale Datei vom Host-Dateisystem als Anhang versenden |
| `get_inbox_config` | Aktuelle Serverkonfiguration anzeigen |

## Setup

### 1. Abhängigkeiten installieren & bauen

```bash
npm install
npm run build
```

### 2. Konfiguration

```bash
cp .env.example .env
```

Werte in `.env` anpassen:

| Variable | Beschreibung | Standard |
|---|---|---|
| `MAIL_HOST` | IMAP-Server | – |
| `MAIL_PORT` | IMAP-Port | `993` |
| `MAIL_SSL` | IMAP SSL | `true` |
| `MAIL_USER` | E-Mail-Adresse | – |
| `MAIL_PASSWORD` | Passwort | – |
| `MAIL_INBOX` | Standard-Posteingang | `INBOX` |
| `MAIL_MAX_EMAILS` | Max. E-Mails pro Abfrage | `50` |
| `SMTP_HOST` | SMTP-Server | – |
| `SMTP_PORT` | SMTP-Port | `587` |
| `SMTP_SSL` | SMTP SSL (true = Port 465) | `false` |
| `SMTP_FROM_NAME` | Absendername | – |

Die `.env`-Datei wird automatisch geladen — es sind keine Umgebungsvariablen im MCP-Client nötig.

## MCP-Integration (mcporter / Claude / VS Code)

```json
{
  "mcpServers": {
    "mailmcp": {
      "command": "node /pfad/zu/mailmcp/dist/server.js"
    }
  }
}
```

## Dateistruktur

```
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
└── .gitignore
```