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.

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
• 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 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.

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"
      }
    }
  }
}

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

Claude Code

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

For read-only mode:

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

Available Tools

Account