README.md
MCP server for the Mailchimp Marketing API.
mailchimp-mcp
MCP server for the Mailchimp Marketing API. Create campaigns, manage audiences, send emails, and handle subscribers.
Tools
| Tool | Description |
|---|---|
list_audiences |
List all audiences/lists |
list_templates |
List email templates |
list_campaigns |
List recent campaigns |
get_campaign |
Get campaign details |
create_campaign |
Create a new email campaign |
set_campaign_content |
Set HTML/template content for a campaign |
get_campaign_content |
Get current campaign content |
send_test_email |
Send a test email before full send |
send_campaign |
Send a campaign to its audience |
schedule_campaign |
Schedule a campaign for future send |
list_members |
List subscribers in an audience |
add_or_update_member |
Add or update a subscriber (upsert) |
batch_add_members |
Bulk add up to 500 subscribers |
Setup
Install dependencies:
npm installCopy
.env.exampleto.envand fill in your API key:cp .env.example .envRequired environment variables:
MAILCHIMP_API_KEY- Your Mailchimp API key (format:key-dc, e.g.abc123-us21)
Usage with Claude Code
Add to your Claude Code MCP config (~/.claude.json):
{
"mcpServers": {
"mailchimp": {
"command": "node",
"args": ["/path/to/mailchimp-mcp/server.js"],
"env": {
"MAILCHIMP_API_KEY": "your-api-key-us21"
}
}
}
}
License
MIT
Tools (13)
list_audiencesList all audiences/listslist_templatesList email templateslist_campaignsList recent campaignsget_campaignGet campaign detailscreate_campaignCreate a new email campaignset_campaign_contentSet HTML/template content for a campaignget_campaign_contentGet current campaign contentsend_test_emailSend a test email before full sendsend_campaignSend a campaign to its audienceschedule_campaignSchedule a campaign for future sendlist_membersList subscribers in an audienceadd_or_update_memberAdd or update a subscriber (upsert)batch_add_membersBulk add up to 500 subscribersEnvironment Variables
MAILCHIMP_API_KEYrequiredYour Mailchimp API key (format: key-dc, e.g. abc123-us21)Configuration
claude_desktop_config.json
{"mcpServers": {"mailchimp": {"command": "node", "args": ["/path/to/mailchimp-mcp/server.js"], "env": {"MAILCHIMP_API_KEY": "your-api-key-us21"}}}}Try it
→List all my current Mailchimp audiences.
→Create a new email campaign for my newsletter audience.
→Add a new subscriber to my main mailing list.
→Schedule my latest campaign to be sent tomorrow morning.
→Send a test email for the current campaign to my address.