Mailchimp MCP Server
Production-grade MCP server for the Mailchimp Marketing API. 33 tools covering campaigns, audiences, members, tags, segments, templates, reports, and automations. Full read/write support — create campaigns, manage subscribers, send emails, track performance. Built for Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.
Overview
mcp-mailchimp
Production-grade MCP server for the Mailchimp Marketing API. 33 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-mailchimp
Or 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-mailchimp
Cursor (.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-mailchimp
Tools (33)
Account
| Tool | Description |
|---|---|
ping | Validate API key and get account info |
Campaigns
| Tool | Description |
|---|---|
list_campaigns | List campaigns with status/audience filters |
get_campaign | Get campaign details (settings, tracking, recipients) |
create_campaign | Create a new email campaign |
update_campaign | Update campaign settings (subject, from_name, etc.) |
send_campaign | Send a campaign immediately |
schedule_campaign | Schedule a campaign for a specific time |
replicate_campaign | Copy an existing campaign |
send_test_email | Send test email to specified addresses |
Campaign Content
| Tool | Description |
|---|---|
get_campaign_content | Get campaign HTML and plain-text content |
set_campaign_content | Set content via HTML or template |
Reports
| Tool | Description |
|---|---|
get_campaign_report | Performance report (opens, clicks, bounces, unsubscribes) |
get_click_report | Click details — which URLs were clicked and how often |
get_open_report | Open details — which subscribers opened and when |
Audiences
| Tool | Description |
|---|---|
list_audiences | List all audiences with subscriber counts |
get_audience | Get audience details and stats |
create_audience | Create a new audience/list |
Members
| Tool | Description |
|---|---|
list_members | List/filter audience members by status |
get_member | Get subscriber details by email |
add_or_update_member | Add new subscriber or update existing (upsert) |
archive_member | Archive (soft-delete) a subscriber |
search_members | Search members across all audiences |
get_member_activity | Recent subscriber activity (opens, clicks, etc.) |
Tags
| Tool | Description |
|---|---|
list_tags | List all tags for an audience |
manage_member_tags | Add or remove tags on a subscriber |
Segments
| Tool | Description |
|---|---|
list_segments | List saved segments for an audience |
get_segment_members | List members in a segment |
create_segment | Create a static segment from email addresses |
Templates
| Tool | Description |
|---|---|
list_templates | List available email templates |
get_template | Get template details and HTML content |
Automations
| Tool | Description |
|---|---|
list_automations | List classic automations |
pause_automation | Pause all emails in a workflow |
start_automation | 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 john@example.com to my newsletter list and tag them as VIP"
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]"
pytest
License
MIT
Server Config
{
"mcpServers": {
"mailchimp": {
"command": "mcp-mailchimp",
"env": {
"MAILCHIMP_API_KEY": "your-api-key-here"
}
}
}
}Project Info
Created At
3 months agoUpdated At
3 months agoAuthor Name
Alex LaGuardiaStar
-Language
-License
-