Skip to main content
Glama
@m6b9/mcp-mailchimp

@m6b9/mcp-mailchimp

by Snouzy

@m6b9/mcp-mailchimp

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

Prerequis

Related MCP server: Mailchimp MCP Server

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

Available Tools

72 tools
add_memberC

Add a new subscriber to an audience

Inputs: email (required), status (required), list_id (required), tags, +1 more.

archive_memberB

Archive (soft-delete) a member from an audience

Inputs: email (required), list_id (required).

create_audienceB

Create a new audience/list with contact info and campaign defaults

Inputs: zip (required), city (required), name (required), state (required), +8 more.

create_campaignC

Create a new email campaign

Inputs: type (required), list_id (required), subject (required), reply_to (required), +2 more.

create_file_folderB

Create a new folder in the file manager

Inputs: name (required).

create_merge_fieldB

Create a new merge field for an audience

Inputs: tag (required), name (required), type (required), list_id (required), +3 more.

create_segmentB

Create a new segment (static or saved/conditional)

Inputs: name (required), list_id (required), match, conditions, +1 more.

create_tagB

Create a new tag for an audience

Inputs: name (required), list_id (required).

create_templateB

Create a new email template

Inputs: html (required), name (required), folder_id.

create_template_folderC

Create a template folder

Inputs: name (required).

create_verified_domainC

Add a domain for verification

Inputs: domain (required).

delete_audienceA

Permanently delete an audience/list

Inputs: list_id (required).

delete_campaignA

Permanently delete a campaign

Inputs: campaign_id (required).

delete_fileB

Delete a file from the file manager

Inputs: file_id (required).

delete_file_folderB

Delete a folder from the file manager

Inputs: folder_id (required).

delete_memberA

Permanently delete a member from an audience (irreversible, unlike archive)

Inputs: email (required), list_id (required).

delete_merge_fieldA

Delete a merge field from an audience

Inputs: list_id (required), merge_field_id (required).

delete_segmentC

Delete a segment

Inputs: list_id (required), segment_id (required).

delete_tagC

Delete a tag from an audience

Inputs: tag_id (required), list_id (required).

delete_templateC

Delete a template

Inputs: template_id (required).

delete_template_folderB

Delete a template folder

Inputs: folder_id (required).

delete_verified_domainC

Remove a verified domain

Inputs: domain (required).

get_audienceC

Get details of a specific Mailchimp audience

Inputs: list_id (required).

get_automationB

Get details of a specific automation workflow

Inputs: workflow_id (required).

get_automation_emailA

Get details of a specific automation email

Inputs: email_id (required), workflow_id (required).

get_campaignC

Get details of a specific campaign

Inputs: campaign_id (required).

get_campaign_contentB

Get the HTML/text content of a campaign

Inputs: campaign_id (required).

get_campaign_reportA

Get detailed performance report for a specific campaign (opens, clicks, bounces, etc.)

Inputs: campaign_id (required).

get_conversationC

Get details of a specific conversation

Inputs: conversation_id (required).

get_fileB

Get details of a specific file

Inputs: file_id (required).

get_file_folderA

Get details of a specific file folder

Inputs: folder_id (required).

get_interestB

Get details of a specific interest

Inputs: list_id (required), category_id (required), interest_id (required).

get_interest_categoryB

Get details of a specific interest category

Inputs: list_id (required), category_id (required).

get_memberA

Get a specific member by email from an audience

Inputs: email (required), list_id (required).

get_merge_fieldB

Get details of a specific merge field

Inputs: list_id (required), merge_field_id (required).

get_segmentA

Get details of a specific segment

Inputs: list_id (required), segment_id (required).

get_templateA

Get a specific template with its HTML content

Inputs: template_id (required).

get_verified_domainA

Get verification status of a specific domain

Inputs: domain (required).

list_audience_activityB

Get recent activity feed for an audience

Inputs: list_id (required), count, offset.

list_audiencesA

List all Mailchimp audiences (lists)

Inputs: count, offset.

list_automation_emailsC

List emails in an automation workflow

Inputs: workflow_id (required).

list_automationsA

List automation workflows

Inputs: count, offset, status.

list_campaignsB

List Mailchimp campaigns

Inputs: type, count, offset, status.

list_conversation_messagesB

List messages in a conversation thread

Inputs: conversation_id (required), count, offset, is_read.

list_conversationsC

List conversations (inbox messages)

Inputs: count, offset, list_id, campaign_id, +1 more.

list_file_foldersB

List folders in the file manager

Inputs: count, offset.

list_filesA

List files in the Mailchimp file manager

Inputs: type, count, offset, folder_id.

list_interest_categoriesB

List interest categories (groups) for an audience

Inputs: list_id (required), count, offset.

list_interestsB

List interests within a category

Inputs: list_id (required), category_id (required), count, offset.

list_membersB

List members of a Mailchimp audience

Inputs: list_id (required), count, offset, status.

list_merge_fieldsA

List merge fields (custom fields) for an audience

Inputs: list_id (required), type, count, offset.

list_reportsA

List campaign reports with performance stats

Inputs: count, offset.

list_segment_membersB

List members in a segment

Inputs: list_id (required), segment_id (required), count, offset.

list_segmentsC

List segments for an audience

Inputs: list_id (required), type, count, offset.

list_tagsB

List all tags for an audience

Inputs: list_id (required), count, offset.

list_template_foldersB

List template folders

Inputs: count, offset.

list_templatesB

List Mailchimp email templates

Inputs: type, count, offset.

list_verified_domainsA

List all verified sending domains

Inputs: no named parameters.

pingA

Test connection and get Mailchimp account info

Inputs: no named parameters.

schedule_campaignB

Schedule a campaign for a future date/time

Inputs: campaign_id (required), schedule_time (required).

search_membersA

Search for members across all audiences by email or name

Inputs: query (required).

send_campaignB

Send a campaign immediately. This action is irreversible.

Inputs: campaign_id (required).

send_domain_verification_emailB

Resend verification email for a domain

Inputs: domain (required).

set_campaign_contentB

Set the HTML content of a campaign

Inputs: html (required), campaign_id (required).

tag_memberA

Add or remove tags on a member

Inputs: tags (required), email (required), list_id (required).

update_audienceC

Update audience settings

Inputs: list_id (required), name, permission_reminder.

update_campaignC

Update campaign settings

Inputs: campaign_id (required), title, subject, reply_to, +1 more.

update_memberC

Update an existing member in an audience

Inputs: email (required), list_id (required), status, merge_fields.

update_merge_fieldC

Update a merge field's properties

Inputs: list_id (required), merge_field_id (required), name, required, +1 more.

update_segmentB

Update a segment's name or conditions

Inputs: list_id (required), segment_id (required), name, match, +2 more.

update_templateA

Update an existing template's name or HTML

Inputs: template_id (required), html, name.

upload_fileA

Upload a file to the Mailchimp file manager (max 10MB)

Inputs: name (required), file_data (required), folder_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 72 tools

    Disambiguation4/5

    Most tools follow a distinct resource+action pattern, and descriptions clarify boundaries (e.g., archive_member vs delete_member). A few pairs like search_members vs list_members or list_reports vs get_campaign_report could cause minor confusion, but overall the purposes are clear.

    Naming Consistency5/5

    All tools use snake_case and predominantly follow verb_noun conventions (list_, get_, create_, update_, delete_). Exceptions like ping and search_members are still predictable and do not break the pattern.

    Tool Count2/5

    At 72 tools, the surface is very large. While it covers many Mailchimp resources, the sheer number makes it heavy and potentially overwhelming for an agent; some resources could have been consolidated or omitted.

    Completeness4/5

    Core CRUD/lifecycle coverage is strong for audiences, members, campaigns, templates, and files. Gaps exist for creating/updating automations and conversations (read-only), but the main email marketing workflows are well supported.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that interfaces with the Mailchimp Marketing API to manage audiences, email campaigns, and subscribers. It enables users to create and schedule campaigns, handle member lists, and send test or live emails through natural language commands.
      13
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A production-grade MCP server that integrates with the Mailchimp Marketing API to manage campaigns, audiences, members, and reports. It provides 28 specialized tools for automating marketing tasks such as sending emails, managing subscriber tags, and analyzing performance data.
      71
      1
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Comprehensive MCP server for the Mautic marketing automation API, providing 203 tools for managing contacts, campaigns, emails, segments, and more.
      2
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      A hybrid Mailchimp MCP server with 12 tools: 10 native tools for common email workflows plus search and execute to access all 282 Mailchimp Marketing API endpoints on demand.
      12
      31 npm
      MIT