@multimail/mcp-server

MCP-Server für MultiMail. Geben Sie Ihrem Agenten eine eigene E-Mail-Adresse mit abgestufter menschlicher Aufsicht — von vollständiger Freigabe bis hin zum autonomen Versand.

Schnelleinstieg

npx @multimail/mcp-server

Setzen Sie MULTIMAIL_API_KEY für den vollen Zugriff oder führen Sie es ohne diesen aus, um zuerst ein Konto zu erstellen. Einen Schlüssel erhalten Sie unter multimail.dev.

Durch die Nutzung von MultiMail stimmen Sie den Nutzungsbedingungen und der Richtlinie zur akzeptablen Nutzung zu.

Related MCP server: MCP Email Server

Einrichtung

Option A: Remote-Server (empfohlen)

Keine Installation erforderlich. Verbinden Sie sich direkt mit unserem gehosteten Server. Die Authentifizierung erfolgt über OAuth im Browser.

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

Funktioniert mit Claude.ai, Claude Desktop, Claude Code und jedem Client, der Remote-MCP-Server unterstützt.

Option B: Lokaler Server (stdio)

Führen Sie den Server lokal aus. Der API-Schlüssel wird als Umgebungsvariable übergeben.

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

Wo dies hinzuzufügen ist

Client	Konfigurationsdatei
Claude Code	`~/.claude/.mcp.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json` in Ihrem Projekt
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Copilot (VS Code)	`.vscode/mcp.json` in Ihrem Projekt
OpenCode	`mcp.json` in Ihrem Projekt
ChatGPT Desktop	Einstellungen > MCP-Server
Jeder MCP-Client	Konsultieren Sie die Dokumentation Ihres Clients für den Konfigurationsort

Umgebungsvariablen

Variable	Erforderlich	Beschreibung
`MULTIMAIL_API_KEY`	Ja	Ihr MultiMail API-Schlüssel (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	Nein	Standard-Postfach-ID. Falls nicht gesetzt, übergeben Sie `mailbox_id` an jedes Tool oder rufen Sie zuerst `list_mailboxes` auf.
`MULTIMAIL_API_URL`	Nein	API-Basis-URL. Standard ist `https://api.multimail.dev`.

Einrichtung beim ersten Start

Bei der ersten Verwendung fordert Sie MultiMail auf, Ihr Postfach zu konfigurieren. Sie können dies auch explizit mit dem Tool configure_mailbox tun:

Aufsichtsmodus: Wie viel menschliche Freigabe ist erforderlich (gated_send, monitored, autonomous usw.)
Anzeigename: Absendername, der in E-Mails angezeigt wird
CC/BCC-Standards: Adressen bei allen ausgehenden E-Mails automatisch in Kopie setzen
Zeitplanung: Geplanten Versand aktivieren/deaktivieren und Standard-Freigabezeit festlegen
Signatur: E-Mail-Signaturblock

Wenn Sie diesen Schritt überspringen, erinnert Sie MultiMail beim ersten Tool-Aufruf daran.

Tools

Tool	Beschreibung
`list_mailboxes`	Alle für diesen API-Schlüssel verfügbaren Postfächer auflisten
`configure_mailbox`	Postfach-Einstellungen einrichten: Aufsichtsmodus, Anzeigename, CC/BCC, Zeitplanung, Signatur
`send_email`	Eine E-Mail mit einem Markdown-Textkörper senden. Unterstützt Anhänge, `idempotency_key` und `send_at` für geplante Zustellung.
`check_inbox`	E-Mails mit Filtern auflisten: Status, Absender, Betreff, Datumsbereich, Richtung, Anhänge, Cursor-Paginierung
`read_email`	Vollständigen E-Mail-Inhalt abrufen. Gibt vertrauenswürdige Metadaten und nicht vertrauenswürdigen Textkörper als separate Inhaltsblöcke zurück.
`reply_email`	Auf eine E-Mail im bestehenden Thread antworten. Unterstützt Anhänge und `idempotency_key`.
`download_attachment`	E-Mail-Anhang als Base64 mit Inhaltstyp herunterladen
`get_thread`	Alle E-Mails in einem Konversations-Thread mit Teilnehmern und Metadaten abrufen
`cancel_message`	Eine ausstehende oder geplante E-Mail stornieren
`schedule_email`	Eine E-Mail für die zukünftige Zustellung mit einer erforderlichen `send_at`-Zeit planen. Vor dem Versand bearbeiten oder stornieren.
`edit_scheduled_email`	Zustellzeit, Empfänger, Betreff oder Textkörper einer geplanten E-Mail vor dem Versand bearbeiten
`update_mailbox`	Postfach-Einstellungen aktualisieren (Anzeigename, Aufsichtsmodus, Signatur, Webhooks)
`update_account`	Kontoeinstellungen aktualisieren (Organisationsname, Aufsichts-E-Mail, physische Adresse)
`delete_mailbox`	Ein Postfach dauerhaft löschen (erfordert Admin-Berechtigung)
`request_challenge`	Eine ALTCHA Proof-of-Work-Challenge für die Kontoerstellung anfordern (kein API-Schlüssel erforderlich)
`create_account`	Ein neues Konto mit einer gelösten PoW-Challenge erstellen (kein API-Schlüssel erforderlich)
`resend_confirmation`	Die Aktivierungs-E-Mail mit einem neuen Code erneut senden (kein API-Schlüssel erforderlich)
`activate_account`	Ein Konto mit dem Code aus der Bestätigungs-E-Mail aktivieren (kein API-Schlüssel erforderlich)
`tag_email`	Schlüssel-Wert-Tags für E-Mails setzen, abrufen oder löschen (persistenter Agenten-Speicher)
`add_contact`	Einen Kontakt mit optionalen Tags zum Adressbuch hinzufügen
`search_contacts`	Adressbuch nach Name oder E-Mail durchsuchen
`get_account`	Kontostatus, Plan, Kontingent, Versandstatus, Durchsetzungsstufe abrufen
`create_mailbox`	Ein neues Postfach erstellen (erfordert Admin-Berechtigung)
`request_upgrade`	Ein Upgrade des Aufsichtsmodus anfordern (Vertrauensleiter)
`apply_upgrade`	Einen Upgrade-Code vom Betreiber anwenden
`get_usage`	Kontingent und Nutzungsstatistiken für den Abrechnungszeitraum prüfen
`list_pending`	E-Mails auflisten, die auf eine Aufsichtsentscheidung warten (erfordert Aufsichts-Berechtigung)
`decide_email`	Eine ausstehende E-Mail genehmigen oder ablehnen (erfordert Aufsichts-Berechtigung)
`delete_contact`	Einen Kontakt aus dem Adressbuch löschen
`check_suppression`	Unterdrückte E-Mail-Adressen auflisten
`remove_suppression`	Eine Adresse aus der Unterdrückungsliste entfernen
`list_api_keys`	Alle API-Schlüssel auflisten (erfordert Admin-Berechtigung)
`create_api_key`	Einen neuen API-Schlüssel mit Bereichen erstellen (erfordert Admin-Berechtigung + Betreiberfreigabe; `send`+`oversight`-Kombinationen werden abgelehnt, um Selbstfreigabe zu verhindern)
`revoke_api_key`	Einen API-Schlüssel widerrufen (erfordert Admin-Berechtigung)
`get_audit_log`	Konto-Audit-Protokoll abrufen (erfordert Admin-Berechtigung)
`delete_account`	Konto und alle Daten dauerhaft löschen (erfordert Admin-Berechtigung)
`wait_for_email`	Blockieren, bis eine neue E-Mail eintrifft, die den Filtern entspricht, oder Zeitüberschreitung (max. 120s)
`create_webhook`	Ein Webhook-Abonnement für Echtzeit-E-Mail-Ereignisbenachrichtigungen erstellen
`list_webhooks`	Alle Webhook-Abonnements für dieses Konto auflisten
`delete_webhook`	Ein Webhook-Abonnement löschen

Funktionsweise

Sie schreiben E-Mail-Texte in Markdown. MultiMail konvertiert diese für die Zustellung in formatiertes HTML.
Eingehende E-Mails kommen als sauberes Markdown an. Kein HTML-Parsing oder MIME-Dekodierung erforderlich.
Threading erfolgt automatisch. Antworten Sie auf eine E-Mail und die Header werden korrekt gesetzt.
Sendungen geben den Status pending_scan zurück, während die E-Mail auf Bedrohungen gescannt wird. Wenn Ihr Postfach eine kontrollierte Aufsicht verwendet, wechselt der Status zur menschlichen Überprüfung auf pending_send_approval. Nicht erneut versuchen oder erneut senden.
Überprüfen Sie andere Agenten durch Prüfung des signierten Headers X-MultiMail-Identity bei empfangenen E-Mails.

Entwicklung

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

Testen

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

Lizenz

MIT

MultiMail

@multimail/mcp-server

Schnelleinstieg

Einrichtung

Option A: Remote-Server (empfohlen)

Option B: Lokaler Server (stdio)

Wo dies hinzuzufügen ist

Umgebungsvariablen

Einrichtung beim ersten Start

Tools

Funktionsweise

Entwicklung

Testen

Lizenz

Resources

Tools

Latest Blog Posts

MCP directory API