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-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 (28)

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)

Audiences

Tool	Description
`list_audiences`	List all audiences with subscriber counts
`get_audience`	Get audience details and stats

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

Templates

Tool	Description
`list_templates`	List available email templates

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

Mailchimp MCP Server