@m6b9/mcp-mailchimp

Serveur MCP pour l'API Mailchimp Marketing v3. 72 tools, zero bloat.

Prerequis

• Node.js >= 20
• Une cle API Mailchimp (format xxx-usXX)

Installation

git clone <repo-url> && cd m6b9-mcp-mailchimp
npm install
npm run build

Configuration

Copier le fichier d'environnement et y mettre ta cle API :

cp .env.example .env

MAILCHIMP_API_KEY=your-api-key-us00

Le server prefix (us11, us21, etc.) est extrait automatiquement de la cle.

Lancement

Mode dev (TypeScript direct)

MAILCHIMP_API_KEY=xxx-us11 npx tsx src/index.ts

Ou avec le .env :

npx tsx --env-file=.env src/index.ts

Mode production (build)

npm run build
MAILCHIMP_API_KEY=xxx-us11 node dist/index.js

Verification

Tester que le serveur repond correctement :

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}\n{"jsonrpc":"2.0","method":"notifications/initialized"}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ping","arguments":{}}}\n' \
  | MAILCHIMP_API_KEY=xxx-us11 node dist/index.js 2>/dev/null \
  | tail -1 | python3 -m json.tool

Si la connexion est OK, tu verras les infos de ton compte (nom, email, nombre de subscribers).

Pour lister tous les tools disponibles :

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}\n{"jsonrpc":"2.0","method":"notifications/initialized"}\n{"jsonrpc":"2.0","id":2,"method":"tools/list"}\n' \
  | MAILCHIMP_API_KEY=xxx-us11 node dist/index.js 2>/dev/null \
  | tail -1 | python3 -c "import sys,json; tools=json.loads(sys.stdin.read())['result']['tools']; [print(t['name']) for t in tools]"

Integration Claude Code

claude mcp add mailchimp -s user \
  -e MAILCHIMP_API_KEY=xxx-us11 \
  -- node /chemin/absolu/vers/m6b9-mcp-mailchimp/dist/index.js

Puis relancer Claude Code. Le serveur sera disponible globalement.

Integration Claude Desktop

Ajouter dans ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/chemin/absolu/vers/m6b9-mcp-mailchimp/dist/index.js"],
      "env": {
        "MAILCHIMP_API_KEY": "xxx-us11"
      }
    }
  }
}

Tools (72)

Module	Tools	Description
Account	ping	Test connexion + infos compte
Audiences	list_audiences get_audience list_audience_activity create_audience update_audience delete_audience	CRUD audiences + activite
Members	list_members get_member search_members add_member update_member archive_member tag_member delete_member	Gestion complete des abonnes
Campaigns	list_campaigns get_campaign create_campaign update_campaign set_campaign_content get_campaign_content send_campaign schedule_campaign delete_campaign	Cycle de vie complet des campagnes
Templates	list_templates get_template create_template update_template delete_template list_template_folders create_template_folder delete_template_folder	Templates + organisation en dossiers
Reports	list_reports get_campaign_report	Analytics et performance
Segments	list_segments get_segment list_segment_members create_segment update_segment delete_segment	Segments statiques et conditionnels
Tags	list_tags create_tag delete_tag	Gestion des tags (segments statiques)
Merge Fields	list_merge_fields get_merge_field create_merge_field update_merge_field delete_merge_field	Champs personnalises
Automations	list_automations get_automation list_automation_emails get_automation_email	Workflows automatises
Interests	list_interest_categories get_interest_category list_interests get_interest	Groupes d'interets
Conversations	list_conversations get_conversation list_conversation_messages	Messagerie inbox
File Manager	list_files get_file upload_file delete_file list_file_folders get_file_folder create_file_folder delete_file_folder	Gestion de fichiers et images
Domains	list_verified_domains get_verified_domain create_verified_domain send_domain_verification_email delete_verified_domain	Domaines d'envoi verifies

Structure

src/
  client.ts              # Client HTTP Mailchimp (fetch + auth Basic)
  index.ts               # Point d'entree MCP (enregistre tous les tools)
  tools/
    audiences.ts         # Audiences / listes
    members.ts           # Abonnes
    campaigns.ts         # Campagnes email
    templates.ts         # Templates + dossiers
    reports.ts           # Rapports de campagne
    segments.ts          # Segments + tags
    merge-fields.ts      # Champs personnalises
    automations.ts       # Workflows
    interests.ts         # Groupes d'interets
    conversations.ts     # Messages inbox
    files.ts             # File manager
    domains.ts           # Domaines verifies

Stack

• @modelcontextprotocol/sdk — SDK officiel MCP
• zod — Validation des parametres
• tsup — Build ESM
• tsx — Dev mode