Mailchimp MCP Server

by AlexlaGuardia

231 downloads

Not rated

GitHub

Other

About

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 Desk

Details

Author: AlexlaGuardia
Downloads: 231
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Mailchimp MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

From the repository

Install with pip install mcp-mailchimp. Obtain a Mailchimp API key from your account settings. Configure your MCP client (e.g., claude_desktop_config.json) with the command mcp-mailchimp and the environment variable MAILCHIMP_API_KEY. Alternatively, run directly with MAILCHIMP_API_KEY=your-key mcp-mailchimp.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mailchimp mcp server": {
            "mailchimp": {
                "command": "mcp-mailchimp",
                "env": {
                    "MAILCHIMP_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

McpServers

{
    "mailchimp": {
        "command": "mcp-mailchimp",
        "env": {
            "MAILCHIMP_API_KEY": "your-api-key-here"
        }
    }
}

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

1. Log in to Mailchimp
2. Go to Account & Billing > Extras > API Keys
3. Click Create A Key
4. 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.) |

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_campaigns with status=sent to show recent campaigns with open/click stats.

"Add john@example.com to my newsletter list and tag them as VIP"
> Uses add_or_update_member then manage_member_tags to subscribe and tag in one flow.

"How did my last campaign perform?"
> Uses list_campaigns to find the latest, then get_campaign_report for opens, clicks, bounces.

"Send a test of my draft campaign to my email"
> Uses send_test_email to 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

mcp-mailchimp

Quick Start

1. Install

2. Get Your API Key

3. Configure Your Client

Tools (33)

Account

Campaigns

Campaign Content

Reports

Audiences

Members

Tags

Segments

Templates

Automations

Examples

Requirements

Development

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀