Provides comprehensive tools for the Mailchimp Marketing API, allowing management of email campaigns, audiences, subscriber lists, tags, segments, templates, reports, and automations.
Click on "Install 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., "@Mailchimp MCP ServerShow me the performance report for my last campaign"
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.
mcp-mailchimp
Production-grade MCP server for the Mailchimp Marketing API. 28 tools covering campaigns, audiences, members, tags, segments, templates, reports, and automations.
Built for Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.
Quick Start
1. Install
pip install mcp-mailchimpOr from source:
git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install .2. Get Your API Key
Log in to Mailchimp
Go to Account & Billing > Extras > API Keys
Click Create A Key
Copy the key (format:
xxxxxxxxxx-usXX)
3. Configure Your Client
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-mailchimpCursor (.cursor/mcp.json):
{
"mcpServers": {
"mailchimp": {
"command": "mcp-mailchimp",
"env": {
"MAILCHIMP_API_KEY": "your-api-key-here"
}
}
}
}Or run directly:
MAILCHIMP_API_KEY=your-key mcp-mailchimpTools (28)
Account
Tool | Description |
| Validate API key and get account info |
Campaigns
Tool | Description |
| List campaigns with status/audience filters |
| Get campaign details (settings, tracking, recipients) |
| Create a new email campaign |
| Update campaign settings (subject, from_name, etc.) |
| Send a campaign immediately |
| Schedule a campaign for a specific time |
| Copy an existing campaign |
| Send test email to specified addresses |
Campaign Content
Tool | Description |
| Get campaign HTML and plain-text content |
| Set content via HTML or template |
Reports
Tool | Description |
| Performance report (opens, clicks, bounces, unsubscribes) |
Audiences
Tool | Description |
| List all audiences with subscriber counts |
| Get audience details and stats |
Members
Tool | Description |
| List/filter audience members by status |
| Get subscriber details by email |
| Add new subscriber or update existing (upsert) |
| Archive (soft-delete) a subscriber |
| Search members across all audiences |
| Recent subscriber activity (opens, clicks, etc.) |
Tags
Tool | Description |
| List all tags for an audience |
| Add or remove tags on a subscriber |
Segments
Tool | Description |
| List saved segments for an audience |
| List members in a segment |
Templates
Tool | Description |
| List available email templates |
Automations
Tool | Description |
| List classic automations |
| Pause all emails in a workflow |
| Start all emails in a workflow |
Examples
"What campaigns have I sent recently?"
Uses
list_campaignswithstatus=sentto show recent campaigns with open/click stats.
"Add
Uses
add_or_update_memberthenmanage_member_tagsto subscribe and tag in one flow.
"How did my last campaign perform?"
Uses
list_campaignsto find the latest, thenget_campaign_reportfor opens, clicks, bounces.
"Send a test of my draft campaign to my email"
Uses
send_test_emailto send a preview before the real send.
Requirements
Python 3.10+
Mailchimp account with API key
MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.)
Development
git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install -e ".[dev]"
pytestLicense
MIT
