mcp-mailchimp

Produktionsreifer MCP-Server für die Mailchimp Marketing-API. 71 Tools für Kampagnen, Zielgruppen, Mitglieder, Tags, Segmente, Vorlagen, Berichte, Automatisierungen, Webhooks, Merge-Felder, Interessengruppen, Landingpages, Batch-Operationen, E-Commerce, A/B-Tests, Mitgliedernotizen, Dateimanager und Zielgruppenanalysen.

Entwickelt für Claude Desktop, Claude Code, Cursor und jeden MCP-kompatiblen Client.

Schnellstart

1. Installation

pip install mcp-mailchimp

Oder aus dem Quellcode:

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install .

2. API-Schlüssel abrufen

Melden Sie sich bei Mailchimp an
Gehen Sie zu Account & Billing > Extras > API Keys
Klicken Sie auf Create A Key
Kopieren Sie den Schlüssel (Format: xxxxxxxxxx-usXX)

3. Client konfigurieren

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code:

claude mcp add mailchimp -- env MAILCHIMP_API_KEY=your-key mcp-mailchimp

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Oder direkt ausführen:

MAILCHIMP_API_KEY=your-key mcp-mailchimp

Tools (71)

Account (1)

Tool	Beschreibung
`ping`	API-Schlüssel validieren und Account-Informationen abrufen

Kampagnen (11)

Tool	Beschreibung
`list_campaigns`	Kampagnen mit Status-/Zielgruppenfiltern auflisten
`get_campaign`	Kampagnendetails abrufen (Einstellungen, Tracking, Empfänger)
`create_campaign`	Neue E-Mail-Kampagne erstellen
`update_campaign`	Kampagneneinstellungen aktualisieren (Betreff, Absendername, etc.)
`send_campaign`	Kampagne sofort versenden
`schedule_campaign`	Kampagne für einen bestimmten Zeitpunkt planen
`unschedule_campaign`	Geplante Kampagne stornieren
`cancel_campaign`	Aktuell versendete Kampagne abbrechen
`delete_campaign`	Kampagnenentwurf dauerhaft löschen
`replicate_campaign`	Bestehende Kampagne kopieren
`send_test_email`	Test-E-Mail an angegebene Adressen senden

Kampagneninhalt (2)

Tool	Beschreibung
`get_campaign_content`	HTML- und Nur-Text-Inhalt der Kampagne abrufen
`set_campaign_content`	Inhalt über HTML oder Vorlage festlegen

Berichte (5)

Tool	Beschreibung
`get_campaign_report`	Leistungsbericht (Öffnungen, Klicks, Bounces, Abmeldungen)
`get_click_report`	Klickdetails – welche URLs wurden wie oft geklickt
`get_open_report`	Öffnungsdetails – welche Abonnenten haben wann geöffnet
`get_unsubscribe_report`	Abmeldedetails – wer hat sich abgemeldet und warum
`get_sent_to_report`	Zustellungsdetails – Empfängerstatus (gesendet, gebounced)

Zielgruppen (4)

Tool	Beschreibung
`list_audiences`	Alle Zielgruppen mit Abonnentenzahlen auflisten
`get_audience`	Zielgruppendetails und Statistiken abrufen
`create_audience`	Neue Zielgruppe/Liste erstellen
`update_audience`	Zielgruppeneinstellungen aktualisieren

Zielgruppenanalysen (3)

Tool	Beschreibung
`get_audience_growth`	Monatliche Wachstumshistorie – Anmeldungen, Abmeldungen, Nettoveränderung
`get_audience_locations`	Aufschlüsselung der Abonnentenstandorte nach Land/Region
`get_email_client_stats`	E-Mail-Domain-Performance – Aufschlüsselung nach Gmail, Outlook, Apple Mail

Mitglieder (8)

Tool	Beschreibung
`list_members`	Zielgruppenmitglieder nach Status auflisten/filtern
`get_member`	Abonnentendetails per E-Mail abrufen
`add_or_update_member`	Neuen Abonnenten hinzufügen oder bestehenden aktualisieren (Upsert)
`archive_member`	Abonnenten archivieren (Soft-Delete)
`delete_member_permanent`	Abonnenten dauerhaft löschen (nicht rückgängig zu machen)
`batch_subscribe_members`	Bis zu 500 Mitglieder gleichzeitig im Batch abonnieren
`search_members`	Mitglieder über alle Zielgruppen hinweg suchen
`get_member_activity`	Letzte Abonnentenaktivität (Öffnungen, Klicks, etc.)

Mitgliedernotizen (2)

Tool	Beschreibung
`list_member_notes`	CRM-artige Notizen zu einem Abonnenten auflisten
`add_member_note`	Notiz zu einem Abonnenten hinzufügen

Tags (2)

Tool	Beschreibung
`list_tags`	Alle Tags für eine Zielgruppe auflisten
`manage_member_tags`	Tags bei einem Abonnenten hinzufügen oder entfernen

Segmente (5)

Tool	Beschreibung
`list_segments`	Gespeicherte Segmente für eine Zielgruppe auflisten
`get_segment_members`	Mitglieder in einem Segment auflisten
`create_segment`	Statisches Segment aus E-Mail-Adressen erstellen
`update_segment`	Segmentnamen aktualisieren oder Mitglieder hinzufügen/entfernen
`delete_segment`	Segment löschen

Merge-Felder (2)

Tool	Beschreibung
`list_merge_fields`	Benutzerdefinierte Felder auflisten (FNAME, LNAME, benutzerdefiniert)
`create_merge_field`	Benutzerdefiniertes Merge-Feld erstellen (Text, Zahl, Datum, etc.)

Interessenkategorien & Gruppen (2)

Tool	Beschreibung
`list_interest_categories`	Interessengruppen auflisten (Checkboxen, Dropdowns, Radios)
`list_interests`	Einzelne Optionen innerhalb einer Kategorie auflisten

Vorlagen (4)

Tool	Beschreibung
`list_templates`	Verfügbare E-Mail-Vorlagen auflisten
`get_template`	Vorlagendetails und HTML-Inhalt abrufen
`create_template`	Neue Vorlage aus HTML erstellen
`delete_template`	Benutzerdefinierte Vorlage löschen

Automatisierungen (5)

Tool	Beschreibung
`list_automations`	Klassische Automatisierungen auflisten
`get_automation`	Automatisierungsdetails und Trigger-Informationen abrufen
`list_automation_emails`	Alle E-Mails in einem Automatisierungs-Workflow auflisten
`pause_automation`	Alle E-Mails in einem Workflow pausieren
`start_automation`	Alle E-Mails in einem Workflow starten

Webhooks (3)

Tool	Beschreibung
`list_webhooks`	Webhooks für eine Zielgruppe auflisten
`create_webhook`	Webhook für Zielgruppenereignisse erstellen
`delete_webhook`	Webhook löschen

E-Commerce (6)

Tool	Beschreibung
`list_ecommerce_stores`	Verbundene Shops auflisten (Shopify, WooCommerce, etc.)
`list_store_products`	Produkte in einem verbundenen Shop auflisten
`list_store_orders`	Bestellungen auflisten – nach Kampagne für Umsatzattribuierung filtern
`get_ecommerce_customer`	Kundendetails mit Bestellanzahl und Gesamtausgaben abrufen
`list_store_carts`	Abgebrochene Warenkörbe für Rückgewinnungskampagnen auflisten
`list_store_promo_codes`	Promo-Codes für eine Promo-Regel auflisten

A/B-Tests (1)

Tool	Beschreibung
`get_ab_test_results`	Ergebnisse der variablen Kampagne abrufen – welche Kombination hat gewonnen

Landingpages (2)

Tool	Beschreibung
`list_landing_pages`	Landingpages mit Besuchs-/Konversionsstatistiken auflisten
`get_landing_page`	Landingpage-Details und Tracking-Daten abrufen

Dateimanager (2)

Tool	Beschreibung
`list_files`	Dateien im Mailchimp-Dateimanager auflisten
`upload_file`	Datei hochladen (base64-kodiert)

Batch-Operationen (1)

Tool	Beschreibung
`create_batch_operation`	Bis zu 500 API-Operationen in einem einzigen Batch übermitteln

Beispiele

"Welche Kampagnen habe ich kürzlich versendet?"

Verwendet list_campaigns mit status=sent, um aktuelle Kampagnen mit Öffnungs-/Klickstatistiken anzuzeigen.

"Wie ist meine Zielgruppe in diesem Quartal gewachsen?"

Verwendet get_audience_growth, um monatliche Trends bei An- und Abmeldungen anzuzeigen.

"Welche Kampagne hat den meisten Umsatz generiert?"

Verwendet list_store_orders mit campaign_id, um die Umsatzattribuierung pro Kampagne zu sehen.

"Zeige mir abgebrochene Warenkörbe aus meinem Shopify-Shop"

Verwendet list_store_carts, um Rückgewinnungsmöglichkeiten zu finden.

"Füge john@example.com eine Notiz hinzu, dass er wegen der Preisgestaltung angerufen hat"

Verwendet add_member_note für CRM-artiges Kontaktmanagement.

"Welche A/B-Test-Betreffzeile hat gewonnen?"

Verwendet get_ab_test_results, um zu sehen, welche Variante am besten abgeschnitten hat.

"Wo befinden sich meine Abonnenten?"

Verwendet get_audience_locations für eine geografische Aufschlüsselung.

Anforderungen

Python 3.10+
Mailchimp-Konto mit API-Schlüssel
MCP-kompatibler Client (Claude Desktop, Claude Code, Cursor, etc.)

Entwicklung

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install -e ".[dev]"
pytest

Lizenz

MIT

Mailchimp MCP Server