damientilman/mailchimp-mcp-server

The most complete Model Context Protocol (MCP) server for the Mailchimp Marketing API: **227 tools** to query and manage your Mailchimp account from any MCP-compatible client. It covers the full campaign, audience, member, segment, automation and reporting surface, complete e-commerce (read and write), landing pages, File Manager, surveys, signup forms and verified domains, plus multi-account support and runtime-security guardrails (read-only, dry-run and audit modes, with per-tool risk metadata).
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.
Quick start
Add it to your MCP client (Claude Desktop, Cursor, Cline, …):
Tip: start with MAILCHIMP_READ_ONLY=true to explore safely, then flip it off when you are ready to write. See Configuration for all options.
Docker
A prebuilt image is published to the GitHub Container Registry on every release:
Or point your MCP client at it:
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
- **File Manager** - Browse stored images and files, and folders
- **Surveys** - List and inspect an audience's surveys
- **Signup forms** - Inspect an audience's signup forms
- **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
- **File Manager** - Upload (base64) and delete images and files
- **Surveys** - Publish and unpublish audience surveys
- **Signup forms** - Customize header, contents, and styles
- **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
**Runtime security**
- **Risk metadata** - Per-tool read / write / destructive classification via MCP annotations and describe_tools
- **Audit log** - Optional structured JSON audit events per dispatch (MAILCHIMP_AUDIT_LOG)
- **Argument validation** - Pagination caps and required-ID checks before every request
Prerequisites
- Python 3.10+
- A Mailchimp API key
Installation
Using uvx (recommended)
No installation needed — run directly:
Using pip
Then run:
From source
Configuration
| Variable | Required | Description |
|---|---|---|
| MAILCHIMP_API_KEY | Yes | Your Mailchimp API key (format: - , e.g. abc123-us8) |
| MAILCHIMP_READ_ONLY | No | Set to true to disable all write operations (default: false) |
| MAILCHIMP_DRY_RUN | No | Set to true to preview write operations without executing them (default: false) |
| MAILCHIMP_API_KEY_ | No | API key for an additional named account (e.g. MAILCHIMP_API_KEY_MARKETING). Target it with the account argument. See Multi-account. |
| MAILCHIMP_READ_ONLY_ | No | Read-only mode for a specific named account (default: false) |
| MAILCHIMP_DRY_RUN_ | No | Dry-run mode for a specific named account (default: false) |
| MAILCHIMP_AUDIT_LOG | No | Set to true to emit a structured JSON audit event per tool dispatch to stderr (default: false). See Runtime security. |
| MAILCHIMP_TOOLS | No | Expose only a subset of tools to shrink the model's tool-list footprint (default: all). See Tool profiles. |