Mailchimp MCP Server

The most complete Model Context Protocol (MCP) server for the Mailchimp Marketing API — 115 tools to query and manage your Mailchimp account from any MCP-compatible client, with A/B campaign support, geographic reporting, full landing-page lifecycle, CRM-style member notes, e-commerce carts and promo codes, Classic Automation + Customer Journey reporting, and read-only / dry-run safety modes.

Uses the Mailchimp Marketing API via requests. Not based on the official mailchimp-marketing-python client. I hit too many issues with it so I went with raw HTTP calls instead.

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
• Merge fields - List custom fields for an audience
• Interest categories & groups - Browse interest categories and options
• Webhooks - List configured webhooks
• Segments - Get segment details, conditions, and member lists
• Automations - List workflows, inspect emails in a workflow, view queues
• Templates - Browse templates and extract HTML content
• 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
• Audiences - Batch subscribe members, update audience settings
• Campaigns - Create drafts, set HTML content, schedule, unschedule, duplicate, delete, send, send test, cancel
• Segments/Tags - Create, update, delete, add/remove members, dynamic conditions
• Merge fields - Create, update, delete custom fields
• Interest categories - Create and delete categories and interests
• Webhooks - Create and delete webhooks
• Templates - Create, update, and delete email templates
• Automations - Pause and start automation workflows
• E-commerce - Cart lifecycle, promo rules, and promo codes for discount 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

Using pip

pip install mailchimp-mcp

Then run:

mailchimp-mcp

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 datacenter (us8, us21, etc.) is automatically extracted from the key.

Safety modes

Read-only mode — When MAILCHIMP_READ_ONLY=true, all write tools (create, update, delete, schedule, etc.) are blocked and return an error. Read tools work normally. This is the recommended default for shared or exploratory setups where you only need reporting and analytics.

Dry-run mode — When MAILCHIMP_DRY_RUN=true, write tools return a preview of the action they would perform (tool name, target resource, parameters) without making any API call. Useful for testing prompts before going live.

MCP client configuration

Most MCP clients accept a JSON configuration block describing how to launch the server. Configure yours to invoke uvx mailchimp-mcp (or mailchimp-mcp if installed via pip) with MAILCHIMP_API_KEY exported in the environment.

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

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

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

CLI-based clients

If your MCP client provides a CLI to register servers, the equivalent invocation is:

mcp-cli add mailchimp \
  -e MAILCHIMP_API_KEY=your-api-key-here \
  -- uvx mailchimp-mcp

Replace mcp-cli with your client's binary name. For read-only mode, add -e MAILCHIMP_READ_ONLY=true to the command.

Available Tools

Account

Campaigns (read)

Campaign Reports

Campaigns (write)

Audiences (read)

Members (read)

Members (write)

Audiences (write)

Segments & Tags

Merge Fields

Interest Categories & Groups

Webhooks

Automations & Customer Journeys

Mailchimp does not expose a public read API for Customer Journeys (only the trigger endpoint above). The search_automation_campaigns, get_member_journey_events and get_automation_summary tools provide the recommended workarounds — they surface every campaign emitted by automations or journeys, even though the journey graph itself remains private.

Templates

Landing Pages

E-commerce

E-commerce Carts

E-commerce Promo Rules & Codes

Batch Operations

Example Prompts

Once connected, you can ask your MCP client to perform requests 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'"
• "Create a campaign targeting only my VIP segment"
• "Send a test email of my draft campaign to [email protected]"
• "List all merge fields for my main audience"
• "Create a dropdown merge field called 'Industry' with options Tech, Finance, Healthcare"
• "Create a dynamic segment of members where FNAME is John"
• "Batch subscribe 50 members from this CSV data"
• "Set up a webhook to notify my app when new subscribers join"
• "Unsubscribe [email protected] from my list"
• "Show me the domain performance breakdown for my last campaign"
• "Where in the world did people open my newsletter? Show me the geographic breakdown."
• "Create an A/B test campaign with two subject lines and pick the winner by opens after 24 hours"
• "What advice does Mailchimp have for improving my last campaign?"
• "Pause my welcome automation"
• "List all orders from my Shopify store this month"

Contributing

Contributions are welcome. See CONTRIBUTING.md for development setup, test instructions, and pull request guidelines.

Security

If you find a security vulnerability, please follow the responsible disclosure process described in SECURITY.md.

Changelog

See CHANGELOG.md for the full release history.

Author

Built by Damien Tilman — [email protected]

License

MIT — see LICENSE for details.