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. - Campaigns - List, search, and inspect campaign details - Reports - Open/clic
Add this skill
npx mdskills install damientilman/mailchimp-mcp-serverComprehensive Mailchimp integration with 53 well-documented tools and thoughtful safety modes
1# Mailchimp MCP Server23[](https://opensource.org/licenses/MIT)4[](https://www.python.org/downloads/)5[](https://modelcontextprotocol.io)67A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for the [Mailchimp Marketing API](https://mailchimp.com/developer/marketing/). 53 tools to query and manage your Mailchimp account directly from Claude.89Uses the [Mailchimp Marketing API](https://mailchimp.com/developer/marketing/api/) via [`requests`](https://pypi.org/project/requests/). Not based on the official [mailchimp-marketing-python](https://github.com/mailchimp/mailchimp-marketing-python) client. I hit too many issues with it so I went with raw HTTP calls instead.1011<a href="https://glama.ai/mcp/servers/@damientilman/mailchimp-mcp">12 <img width="380" height="200" src="https://glama.ai/mcp/servers/@damientilman/mailchimp-mcp/badge" alt="Mailchimp MCP server" />13</a>1415## Features1617**Read**18- **Campaigns** - List, search, and inspect campaign details19- **Reports** - Open/click rates, bounces, per-link clicks, domain performance, unsubscribe details20- **Email activity** - Per-recipient open/click tracking, member activity history21- **Audiences** - Browse audiences, members, segments, tags, and growth history22- **Automations** - List workflows, inspect emails in a workflow, view queues23- **Templates** - Browse available email templates24- **Landing pages** - List and inspect landing pages25- **E-commerce** - Stores, orders, products, customers (requires e-commerce integration)26- **Campaign folders** - Browse folder organization27- **Batch operations** - Monitor bulk operation status2829**Write**30- **Members** - Add, update, unsubscribe, delete, and tag contacts31- **Campaigns** - Create drafts, set HTML content, schedule, unschedule, duplicate, delete32- **Segments/Tags** - Create, delete, add/remove members33- **Automations** - Pause and start automation workflows34- **Batch** - Run bulk API operations in a single request3536## Prerequisites3738- Python 3.10+39- A [Mailchimp API key](https://mailchimp.com/help/about-api-keys/)4041## Installation4243### Using `uvx` (recommended)4445No installation needed — run directly:4647```bash48uvx mailchimp-mcp-server49```5051### Using `pip`5253```bash54pip install mailchimp-mcp-server55```5657Then run:5859```bash60mailchimp-mcp-server61```6263### From source6465```bash66git clone https://github.com/damientilman/mailchimp-mcp-server.git67cd mailchimp-mcp-server68python -m venv .venv69source .venv/bin/activate70pip install -e .71```7273## Configuration7475| Variable | Required | Description |76|---|---|---|77| `MAILCHIMP_API_KEY` | Yes | Your Mailchimp API key (format: `<key>-<dc>`, e.g. `abc123-us8`) |78| `MAILCHIMP_READ_ONLY` | No | Set to `true` to disable all write operations (default: `false`) |79| `MAILCHIMP_DRY_RUN` | No | Set to `true` to preview write operations without executing them (default: `false`) |8081The datacenter (`us8`, `us21`, etc.) is automatically extracted from the key.8283### Safety modes8485**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.8687**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.8889### Claude Desktop9091Add this to your `claude_desktop_config.json`:9293<details>94<summary>Using uvx (recommended)</summary>9596```json97{98 "mcpServers": {99 "mailchimp": {100 "command": "uvx",101 "args": ["mailchimp-mcp-server"],102 "env": {103 "MAILCHIMP_API_KEY": "your-api-key-here"104 }105 }106 }107}108```109</details>110111<details>112<summary>Using pip install</summary>113114```json115{116 "mcpServers": {117 "mailchimp": {118 "command": "mailchimp-mcp-server",119 "env": {120 "MAILCHIMP_API_KEY": "your-api-key-here"121 }122 }123 }124}125```126</details>127128<details>129<summary>Read-only mode (recommended for exploration)</summary>130131```json132{133 "mcpServers": {134 "mailchimp": {135 "command": "uvx",136 "args": ["mailchimp-mcp-server"],137 "env": {138 "MAILCHIMP_API_KEY": "your-api-key-here",139 "MAILCHIMP_READ_ONLY": "true"140 }141 }142 }143}144```145</details>146147### Claude Code148149```bash150claude mcp add mailchimp \151 -s user \152 -e MAILCHIMP_API_KEY=your-api-key-here \153 -- uvx mailchimp-mcp-server154```155156For read-only mode:157158```bash159claude mcp add mailchimp \160 -s user \161 -e MAILCHIMP_API_KEY=your-api-key-here \162 -e MAILCHIMP_READ_ONLY=true \163 -- uvx mailchimp-mcp-server164```165166## Available Tools167168### Account169170| Tool | Description |171|---|---|172| `get_account_info` | Get account name, email, and subscriber count |173174### Campaigns (read)175176| Tool | Description |177|---|---|178| `list_campaigns` | List campaigns with optional filters (status, date) |179| `get_campaign_details` | Get full details of a specific campaign |180| `list_campaign_folders` | List campaign folders |181182### Campaign Reports183184| Tool | Description |185|---|---|186| `get_campaign_report` | Get performance metrics (opens, clicks, bounces) |187| `get_campaign_click_details` | Get per-link click data for a campaign |188| `get_email_activity` | Per-recipient activity (opens, clicks, bounces) |189| `get_open_details` | Who opened, when, how many times |190| `get_campaign_recipients` | List of recipients with delivery status |191| `get_campaign_unsubscribes` | Who unsubscribed after a campaign |192| `get_domain_performance` | Performance by email domain (gmail, outlook, etc.) |193| `get_ecommerce_product_activity` | Revenue per product for a campaign |194| `get_campaign_sub_reports` | Sub-reports (A/B tests, RSS, etc.) |195196### Campaigns (write)197198| Tool | Description |199|---|---|200| `create_campaign` | Create a new campaign draft |201| `update_campaign` | Update subject line, title, preview text, etc. |202| `set_campaign_content` | Set the HTML content of a campaign draft |203| `schedule_campaign` | Schedule a campaign for a specific date/time |204| `unschedule_campaign` | Unschedule a campaign (back to draft) |205| `replicate_campaign` | Duplicate an existing campaign |206| `delete_campaign` | Delete an unsent campaign |207208### Audiences (read)209210| Tool | Description |211|---|---|212| `list_audiences` | List all audiences with stats |213| `get_audience_details` | Get detailed info for a specific audience |214| `list_audience_members` | List members with optional status filter |215| `search_members` | Search members by email or name |216| `get_audience_growth_history` | Monthly growth data (subscribes, unsubscribes) |217| `list_segments` | List segments and tags for an audience |218219### Members (read)220221| Tool | Description |222|---|---|223| `get_member_activity` | Activity history of a specific contact |224| `get_member_tags` | All tags assigned to a contact |225| `get_member_events` | Custom events for a contact |226227### Members (write)228229| Tool | Description |230|---|---|231| `add_member` | Add a new contact to an audience |232| `update_member` | Update a contact's name or status |233| `unsubscribe_member` | Unsubscribe a contact |234| `delete_member` | Permanently delete a contact |235| `tag_member` | Add or remove tags from a contact |236237### Segments & Tags (write)238239| Tool | Description |240|---|---|241| `create_segment` | Create a new segment or tag |242| `delete_segment` | Delete a segment or tag |243| `add_members_to_segment` | Add contacts to a segment/tag |244| `remove_members_from_segment` | Remove contacts from a segment/tag |245246### Automations247248| Tool | Description |249|---|---|250| `list_automations` | List automated email workflows |251| `get_automation_emails` | List emails in a workflow |252| `get_automation_email_queue` | View the send queue for an automation email |253| `pause_automation` | Pause all emails in a workflow |254| `start_automation` | Start/resume all emails in a workflow |255256### Templates257258| Tool | Description |259|---|---|260| `list_templates` | List available email templates |261262### Landing Pages263264| Tool | Description |265|---|---|266| `list_landing_pages` | List all landing pages |267| `get_landing_page` | Get details of a landing page |268269### E-commerce270271| Tool | Description |272|---|---|273| `list_ecommerce_stores` | List connected e-commerce stores |274| `list_store_orders` | List orders from a store |275| `list_store_products` | List products from a store |276| `list_store_customers` | List customers from a store |277278### Batch Operations279280| Tool | Description |281|---|---|282| `create_batch` | Run multiple API operations in bulk |283| `get_batch_status` | Check status of a batch operation |284| `list_batches` | List recent batch operations |285286## Example Prompts287288Once connected, you can ask Claude things like:289290- *"Show me all my sent campaigns from the last 3 months"*291- *"What was the open rate and click rate for my last newsletter?"*292- *"How many subscribers did I gain this year?"*293- *"Which links got the most clicks in campaign X?"*294- *"Search for subscriber john@example.com"*295- *"Add tag 'VIP' to all members who opened my last campaign"*296- *"Create a draft campaign for my main audience with subject 'March Update'"*297- *"Unsubscribe user@example.com from my list"*298- *"Show me the domain performance breakdown for my last campaign"*299- *"Pause my welcome automation"*300- *"List all orders from my Shopify store this month"*301302## Author303304Built by [Damien Tilman](https://www.tilman.marketing) — damien@tilman.marketing305306## License307308MIT — see [LICENSE](LICENSE) for details.
Full transparency — inspect the skill content before installing.