Mailchimp MCP Server

Mailchimp MCP Server

A Model Context Protocol (MCP) server for the Mailchimp Marketing API. 53 tools to query and manage your Mailchimp account directly from Claude.

Features

Read

• Campaigns - List, search, and inspect campaign details
• Reports - Open/click rates, bounces, per-link clicks, domain performance, unsubscribe details
• Email activity - Per-recipient open/click tracking, member activity history
• Audiences - Browse audiences, members, segments, tags, and growth history
• Automations - List workflows, inspect emails in a workflow, view queues
• Templates - Browse available email templates
• Landing pages - List and inspect landing pages
• E-commerce - Stores, orders, products, customers (requires e-commerce integration)
• Campaign folders - Browse folder organization
• Batch operations - Monitor bulk operation status

Write

• Members - Add, update, unsubscribe, delete, and tag contacts
• Campaigns - Create drafts, set HTML content, schedule, unschedule, duplicate, delete
• Segments/Tags - Create, delete, add/remove members
• Automations - Pause and start automation workflows
• Batch - Run bulk API operations in a single request

Prerequisites

• Python 3.10+
• A Mailchimp API key

Installation

Using uvx (recommended)

No installation needed — run directly:

uvx mailchimp-mcp-server

Using pip

pip install mailchimp-mcp-server

Then run:

mailchimp-mcp-server

From source

git clone https://github.com/damientilman/mailchimp-mcp-server.git
cd mailchimp-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

The server requires one environment variable:

The datacenter (us8, us21, etc.) is automatically extracted from the key.

Claude Desktop

Add this to your claude_desktop_config.json:

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

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

Claude Code

claude mcp add mailchimp \
  -s user \
  -e MAILCHIMP_API_KEY=your-api-key-here \
  -- uvx mailchimp-mcp-server

Available Tools

Account

Campaigns (read)

Campaign Reports

Campaigns (write)

Audiences (read)

Members (read)

Members (write)

Segments & Tags (write)

Automations

Templates

Landing Pages

E-commerce

Batch Operations

Example Prompts

Once connected, you can ask Claude things like:

• "Show me all my sent campaigns from the last 3 months"
• "What was the open rate and click rate for my last newsletter?"
• "How many subscribers did I gain this year?"
• "Which links got the most clicks in campaign X?"
• "Search for subscriber [email protected]"
• "Add tag 'VIP' to all members who opened my last campaign"
• "Create a draft campaign for my main audience with subject 'March Update'"
• "Unsubscribe [email protected] from my list"
• "Show me the domain performance breakdown for my last campaign"
• "Pause my welcome automation"
• "List all orders from my Shopify store this month"

Author

Built by Damien Tilman — [email protected]

License

MIT — see LICENSE for details.