@m6b9/mcp-mailchimp
Interact with Mailchimp Marketing API v3 to manage audiences, members, campaigns, templates, reports, segments, tags, merge fields, automations, interests, conversations, file manager, and domains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@m6b9/mcp-mailchimp add member john@example.com to my main audience"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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)
Related MCP server: Mailchimp MCP Server
Installation
git clone <repo-url> && cd m6b9-mcp-mailchimp
npm install
npm run buildConfiguration
Copier le fichier d'environnement et y mettre ta cle API :
cp .env.example .envMAILCHIMP_API_KEY=your-api-key-us00Le 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.tsOu avec le .env :
npx tsx --env-file=.env src/index.tsMode production (build)
npm run build
MAILCHIMP_API_KEY=xxx-us11 node dist/index.jsVerification
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.toolSi 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.jsPuis 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 |
| Test connexion + infos compte |
Audiences |
| CRUD audiences + activite |
Members |
| Gestion complete des abonnes |
Campaigns |
| Cycle de vie complet des campagnes |
Templates |
| Templates + organisation en dossiers |
Reports |
| Analytics et performance |
Segments |
| Segments statiques et conditionnels |
Tags |
| Gestion des tags (segments statiques) |
Merge Fields |
| Champs personnalises |
Automations |
| Workflows automatises |
Interests |
| Groupes d'interets |
Conversations |
| Messagerie inbox |
File Manager |
| Gestion de fichiers et images |
Domains |
| 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 verifiesStack
@modelcontextprotocol/sdk— SDK officiel MCPzod— Validation des parametrestsup— Build ESMtsx— Dev mode
Available Tools
72 toolsadd_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
Scored across 72 tools
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.
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.
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.
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
Mailchimp MCP Pack — manage audiences, campaigns, and members via Mailchimp Marketing API.
Hosted Mailchimp MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Official remote MCP server of MailSenpai, the EU-hosted email marketing platform. Connect Claude, ChatGPT, Cursor or another MCP client with OAuth 2.1 and PKCE. 74 tools manage lists, subscribers, segments, templates, draft campaigns and stats, and check email DNS, blacklists and spam. Sends and deletions require explicit confirmation; every call is logged. The same team also offers SMTP Senpai, an SMTP relay and email API for transactional sending: https://en.mailsenpai.com/smtp-senpai/.
Control newsletters, contacts and automations of Inviomail (German newsletter & email automation tool) from Claude, ChatGPT or your own agents. Hosted in Germany. Remote MCP server with 90+ tools for contacts, lists, tags, newsletters, automation flows and reports. OAuth or Bearer MCP key. Docs: https://admin.inviomail.de/api/docs/mcp
Related MCP Servers
- AlicenseAqualityDmaintenanceAn 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.13MIT
- AlicenseBqualityDmaintenanceA 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.711MIT
- AlicenseNot gradedqualityFmaintenanceComprehensive MCP server for the Mautic marketing automation API, providing 203 tools for managing contacts, campaigns, emails, segments, and more.2ISC
- AlicenseAqualityDmaintenanceA 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.1231 npmMIT