Mailchimp MCP Server
The Mailchimp MCP Server provides 33 tools for comprehensive management of Mailchimp marketing operations through MCP-compatible clients like Claude Desktop, Claude Code, and Cursor.
Account
Validate your API key and retrieve account info (name, email, total subscribers)
Campaigns
List, retrieve, create, update, send, schedule, replicate, and send test emails for campaigns
Supports campaign types: regular, plaintext, A/B split, and RSS
Campaign Content
Get and set a campaign's HTML and plain-text content via custom HTML or a template
Reports
Get performance reports (opens, clicks, bounces, unsubscribes)
Get click details (which URLs were clicked and how often)
Get open details (which subscribers opened and when)
Audiences
List all audiences, get detailed info and stats for a specific audience, and create new ones
Members
List, filter, retrieve, add/update (upsert), archive, and search subscribers
Get recent activity for a subscriber (opens, clicks, bounces)
Tags
List all tags for an audience and add/remove tags on individual subscribers
Segments
List saved segments, get members in a segment, and create static segments from email addresses
Templates
List available email templates and retrieve their details and HTML content
Automations
List classic automation workflows and pause or start them
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. 71 tools covering campaigns, audiences, members, tags, segments, templates, reports, automations, webhooks, merge fields, interest groups, landing pages, batch operations, e-commerce, A/B testing, member notes, file manager, and audience analytics.
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 (71)
Account (1)
Tool | Description |
| Validate API key and get account info |
Campaigns (11)
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 |
| Unschedule a scheduled campaign |
| Cancel a campaign currently sending |
| Permanently delete a draft campaign |
| Copy an existing campaign |
| Send test email to specified addresses |
Campaign Content (2)
Tool | Description |
| Get campaign HTML and plain-text content |
| Set content via HTML or template |
Reports (5)
Tool | Description |
| Performance report (opens, clicks, bounces, unsubscribes) |
| Click details -- which URLs were clicked and how often |
| Open details -- which subscribers opened and when |
| Unsubscribe details -- who left and why |
| Delivery details -- recipient status (sent, bounced) |
Audiences (4)
Tool | Description |
| List all audiences with subscriber counts |
| Get audience details and stats |
| Create a new audience/list |
| Update audience settings |
Audience Analytics (3)
Tool | Description |
| Monthly growth history -- subscribes, unsubscribes, net change |
| Subscriber location breakdown by country/region |
| Email domain performance -- Gmail, Outlook, Apple Mail breakdown |
Members (8)
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 |
| Permanently delete a subscriber (irreversible) |
| Batch subscribe up to 500 members at once |
| Search members across all audiences |
| Recent subscriber activity (opens, clicks, etc.) |
Member Notes (2)
Tool | Description |
| List CRM-style notes on a subscriber |
| Add a note to a subscriber |
Tags (2)
Tool | Description |
| List all tags for an audience |
| Add or remove tags on a subscriber |
Segments (5)
Tool | Description |
| List saved segments for an audience |
| List members in a segment |
| Create a static segment from email addresses |
| Update segment name or add/remove members |
| Delete a segment |
Merge Fields (2)
Tool | Description |
| List custom fields (FNAME, LNAME, custom) |
| Create a custom merge field (text, number, date, etc.) |
Interest Categories & Groups (2)
Tool | Description |
| List interest groups (checkboxes, dropdowns, radios) |
| List individual options within a category |
Templates (4)
Tool | Description |
| List available email templates |
| Get template details and HTML content |
| Create a new template from HTML |
| Delete a custom template |
Automations (5)
Tool | Description |
| List classic automations |
| Get automation details and trigger info |
| List all emails in an automation workflow |
| Pause all emails in a workflow |
| Start all emails in a workflow |
Webhooks (3)
Tool | Description |
| List webhooks for an audience |
| Create a webhook for audience events |
| Delete a webhook |
E-Commerce (6)
Tool | Description |
| List connected stores (Shopify, WooCommerce, etc.) |
| List products in a connected store |
| List orders -- filter by campaign for revenue attribution |
| Get customer details with order count and total spent |
| List abandoned carts for recovery campaigns |
| List promo codes for a promo rule |
A/B Testing (1)
Tool | Description |
| Get variate campaign results -- which combination won |
Landing Pages (2)
Tool | Description |
| List landing pages with visit/conversion stats |
| Get landing page details and tracking data |
File Manager (2)
Tool | Description |
| List files in the Mailchimp file manager |
| Upload a file (base64-encoded) |
Batch Operations (1)
Tool | Description |
| Submit up to 500 API operations in a single batch |
Examples
"What campaigns have I sent recently?"
Uses
list_campaignswithstatus=sentto show recent campaigns with open/click stats.
"How has my audience grown this quarter?"
Uses
get_audience_growthto show monthly subscribe/unsubscribe trends.
"Which campaign drove the most revenue?"
Uses
list_store_orderswithcampaign_idto see revenue attribution per campaign.
"Show me abandoned carts from my Shopify store"
Uses
list_store_cartsto find recovery opportunities.
"Add a note to john@example.com that he called about pricing"
Uses
add_member_notefor CRM-style contact management.
"What A/B test subject line won?"
Uses
get_ab_test_resultsto see which variant performed best.
"Where are my subscribers located?"
Uses
get_audience_locationsfor geographic breakdown.
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
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlexlaGuardia/mcp-mailchimp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server