Provides comprehensive coverage of the Mailchimp Marketing API v3.0 with over 104 tools for managing campaigns, audiences, members, e-commerce, automations, reports, landing pages, templates, tags, and search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Mailchimp MCP Server Create a new email campaign for my list."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Complete Model Context Protocol (MCP) server for Mailchimp Marketing API v3.0 with 104+ tools and 15+ React UI apps.
Comprehensive coverage of the Mailchimp Marketing API v3.0:
Campaigns (15 tools): Create, manage, send, schedule, and test email campaigns
Lists/Audiences (14 tools): Manage lists, segments, interest categories, and growth analytics
Members (12 tools): Add, update, tag, and track list subscribers
Ecommerce (28 tools): Manage stores, products, orders, carts, customers, and promo codes
Automations (10 tools): Manage automation workflows and emails
Reports (8 tools): Access campaign analytics, click tracking, and performance data
Landing Pages (8 tools): Create and manage landing pages
Templates (6 tools): Manage email templates
Search (2 tools): Search campaigns and members
Tags (1 tool): Search and manage tags
Beautiful, dark-themed React applications for visual interaction:
Campaign Dashboard - View and manage all campaigns
Audience Manager - Comprehensive audience/list management
Subscriber Grid - Searchable subscriber table
Segment Builder - Create and manage segments
Template Gallery - Browse and use email templates
Automation Flow - Manage automation workflows
Campaign Analytics - Detailed campaign performance metrics
A/B Test Results - Compare A/B test outcomes
Email Preview - Preview campaign emails
Tag Manager - Organize and apply tags
Landing Page Builder - Create landing pages
Content Manager - Manage email content
Growth Chart - Visualize audience growth over time
Send Time Optimizer - Find optimal send times
List Health Monitor - Track list health metrics
Ecommerce Dashboard - Manage stores and products
Promo Code Manager - Create and track promo codes
Related MCP server: Mailchimp MCP Server
npm install
npm run buildSet your Mailchimp API key as an environment variable:
export MAILCHIMP_API_KEY="your-api-key-us19"Your API key format: xxxxxxxxxxxxxxxxxxxxx-datacenter (e.g., abc123-us19)
You can obtain your API key from: Mailchimp Account → Extras → API Keys
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"mailchimp": {
"command": "node",
"args": ["/path/to/servers/mailchimp/dist/index.js"],
"env": {
"MAILCHIMP_API_KEY": "your-api-key-us19"
}
}
}
}npm startCreate campaigns (regular, A/B split, RSS, variate)
Set HTML/template content
Send, schedule, pause, resume campaigns
Send test emails
Replicate campaigns
Get send checklist
Create and manage audiences
Add/update/remove members (batch operations supported)
Create segments (static, saved, fuzzy)
Manage interest categories and groups
Track growth history
Add/update members with merge fields
Tag management (add/remove tags)
Track member activity and goals
Bulk subscribe operations
VIP member designation
List all automations
Pause/start workflows
Manage automation emails
Queue management
Campaign performance reports
Click-through tracking
Open rate details
Domain performance analysis
A/B test results
Email activity per subscriber
Store management
Product catalog (variants, SKUs, inventory)
Order tracking
Cart abandonment
Customer management
Promo rules and codes
Template gallery
Create custom templates
Landing page builder
Publish/unpublish pages
All apps use a consistent dark theme with Tailwind CSS:
Background: bg-gray-900
Cards: bg-gray-800 with border-gray-700
Accents: Blue (blue-400, blue-600) and Green (green-400, green-600)
Typography: White text with gray variants for hierarchy
cd src/ui/react-app/campaign-dashboard
npm install
npm run devThe server uses HTTP Basic authentication with Mailchimp's API:
Username: anystring (Mailchimp ignores this)
Password: Your API key
Mailchimp enforces rate limits (typically 10 requests/second). The client automatically:
Tracks rate limit headers
Waits when limit is reached
Resumes after reset time
{
"type": "regular",
"recipients": {
"list_id": "abc123"
},
"settings": {
"subject_line": "Welcome to our newsletter!",
"from_name": "Your Company",
"reply_to": "hello@yourcompany.com",
"title": "Welcome Campaign"
}
}{
"list_id": "abc123",
"email_address": "subscriber@example.com",
"status": "subscribed",
"merge_fields": {
"FNAME": "John",
"LNAME": "Doe"
}
}{
"campaign_id": "abc123"
}npm run typecheck # TypeScript type checking
npm test # Run tests (if configured)mailchimp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── clients/
│ │ └── mailchimp.ts # Mailchimp API client
│ ├── tools/
│ │ ├── campaigns-tools.ts
│ │ ├── lists-tools.ts
│ │ ├── members-tools.ts
│ │ ├── automations-tools.ts
│ │ ├── templates-tools.ts
│ │ ├── reports-tools.ts
│ │ ├── landing-pages-tools.ts
│ │ ├── ecommerce-tools.ts
│ │ ├── tags-tools.ts
│ │ └── search-tools.ts
│ ├── types/
│ │ └── index.ts # TypeScript type definitions
│ └── ui/
│ └── react-app/ # 15+ React applications
│ ├── campaign-dashboard/
│ ├── audience-manager/
│ ├── subscriber-grid/
│ └── ... (12+ more apps)
├── dist/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.mdMIT
Contributions welcome! Please read our contributing guidelines and submit PRs.
Issues: GitHub Issues
Built with ❤️ for the MCP community
Batch subscribe or update multiple members in a single API call (up to 500 members)
Inputs: list_id (required), members (required), update_existing.
Create a new saved or static segment for a list
Inputs: name (required), list_id (required), options, static_segment.
Get month-by-month growth history for an audience showing subscriptions and unsubscriptions
Inputs: list_id (required), count, offset, sort_dir, +1 more.
Get all interest categories (groups) for a list
Inputs: list_id (required), type, count, offset.
Get all segments for a list/audience
Inputs: list_id (required), type, count, offset, +4 more.
Get detailed statistics for a specific audience/list including subscriber counts, open/click rates, and growth data
Inputs: list_id (required).
Manually add a subscriber to an automation email queue
Inputs: email_id (required), workflow_id (required), email_address (required).
Get information about a specific automation workflow
Inputs: workflow_id (required).
Get information about a specific automation email
Inputs: email_id (required), workflow_id (required).
Get all automations (classic automations/workflows) in your account
Inputs: count, offset, status, since_start_time, +3 more.
Get all emails in an automation workflow
Inputs: workflow_id (required).
Get all subscribers in the queue for an automation email
Inputs: email_id (required), workflow_id (required).
Pause all emails in an automation workflow
Inputs: workflow_id (required).
Pause a specific automation email
Inputs: email_id (required), workflow_id (required).
Start all emails in an automation workflow
Inputs: workflow_id (required).
Start a specific automation email
Inputs: email_id (required), workflow_id (required).
Create a new campaign
Inputs: type (required), settings (required), recipients (required).
Permanently delete a campaign
Inputs: campaign_id (required).
Get details for a specific campaign by ID
Inputs: campaign_id (required).
Get the HTML and plain-text content for a campaign
Inputs: campaign_id (required).
Review pre-send checklist for a campaign
Inputs: campaign_id (required).
List all campaigns in your Mailchimp account with optional filters
Inputs: type, count, offset, status, +4 more.
Pause an RSS campaign
Inputs: campaign_id (required).
Replicate (duplicate) a campaign
Inputs: campaign_id (required).
Resume a paused RSS campaign
Inputs: campaign_id (required).
Schedule a campaign to be sent at a specific time
Inputs: campaign_id (required), schedule_time (required), timewarp, batch_delivery.
Send a campaign immediately
Inputs: campaign_id (required).
Set the content for a campaign (HTML, plain text, template, or URL)
Inputs: campaign_id (required), url, html, template, +1 more.
Send a test email for a campaign
Inputs: send_type (required), campaign_id (required), test_emails (required).
Unschedule a scheduled campaign
Inputs: campaign_id (required).
Update a campaign's settings
Inputs: campaign_id (required), settings, tracking, recipients.
Add a new cart (for abandoned cart tracking)
Inputs: id (required), lines (required), customer (required), store_id (required), +3 more.
Delete a cart
Inputs: cart_id (required), store_id (required).
Get information about a specific cart
Inputs: cart_id (required), store_id (required).
Get all carts (abandoned carts) for a store
Inputs: store_id (required), count, offset.
Update a cart
Inputs: cart_id (required), store_id (required), lines, order_total, +1 more.
Add a new customer
Inputs: id (required), store_id (required), email_address (required), opt_in_status (required), +3 more.
Delete a customer
Inputs: store_id (required), customer_id (required).
Get information about a specific customer
Inputs: store_id (required), customer_id (required).
Get all customers for a store
Inputs: store_id (required), count, offset, email_address.
Update a customer
Inputs: store_id (required), customer_id (required), last_name, first_name, +1 more.
Add a new order
Inputs: id (required), lines (required), customer (required), store_id (required), +5 more.
Delete an order
Inputs: order_id (required), store_id (required).
Get information about a specific order
Inputs: order_id (required), store_id (required).
Get all orders for a store
Inputs: store_id (required), count, offset, campaign_id, +1 more.
Update an order
Inputs: order_id (required), store_id (required), lines, customer, +2 more.
Add a new product to a store
Inputs: id (required), title (required), store_id (required), variants (required), +6 more.
Delete a product
Inputs: store_id (required), product_id (required).
Get information about a specific product
Inputs: store_id (required), product_id (required).
Get all products for a store
Inputs: store_id (required), count, offset.
Update a product
Inputs: store_id (required), product_id (required), url, title, +2 more.
Add a promo code to a promo rule
Inputs: id (required), code (required), rule_id (required), store_id (required), +2 more.
Get all promo codes for a promo rule
Inputs: rule_id (required), store_id (required), count, offset.
Get all promo rules for a store
Inputs: store_id (required), count, offset.
Add a new e-commerce store
Inputs: id (required), name (required), list_id (required), currency_code (required), +4 more.
Delete a store
Inputs: store_id (required).
Get information about a specific store
Inputs: store_id (required).
Get all e-commerce stores connected to your account
Inputs: count, offset.
Update a store
Inputs: store_id (required), name, domain, currency_code, +1 more.
Create a new landing page
Inputs: name (required), template_id (required), title, list_id, +3 more.
Delete a landing page
Inputs: page_id (required).
Get information about a specific landing page
Inputs: page_id (required).
Get the HTML content for a landing page
Inputs: page_id (required).
Get all landing pages in your Mailchimp account
Inputs: count, offset, sort_dir, sort_field.
Publish a landing page
Inputs: page_id (required).
Unpublish a landing page
Inputs: page_id (required).
Update a landing page
Inputs: page_id (required), name, title, list_id, +2 more.
Batch add or update multiple list members at once
Inputs: list_id (required), members (required), update_existing.
Create a new audience/list
Inputs: name (required), contact (required), campaign_defaults (required), email_type_option (required), +3 more.
Create a new segment for a list
Inputs: name (required), list_id (required), options, static_segment.
Permanently delete a list and all its members
Inputs: list_id (required).
Delete a segment
Inputs: list_id (required), segment_id (required).
Get details for a specific list/audience
Inputs: list_id (required).
Get month-by-month growth statistics for a list
Inputs: list_id (required), count, offset, sort_dir, +1 more.
Get all interest categories (group titles) for a list
Inputs: list_id (required), type, count, offset.
Get all interests (group names) in a specific interest category
Inputs: list_id (required), category_id (required), count, offset.
Get details for a specific segment
Inputs: list_id (required), segment_id (required).
Get all segments for a list
Inputs: list_id (required), type, count, offset, +2 more.
Get all lists/audiences in your Mailchimp account
Inputs: count, email, offset, sort_dir, +3 more.
Update list settings
Inputs: list_id (required), name, contact, campaign_defaults, +2 more.
Update a segment
Inputs: list_id (required), segment_id (required), name, options.
Add a new member to a list
Inputs: status (required), list_id (required), email_address (required), vip, +5 more.
Add a new member or update existing member (upsert)
Inputs: list_id (required), email_address (required), status_if_new (required), vip, +3 more.
Add or remove tags for a member
Inputs: tags (required), list_id (required), email_address (required).
Permanently delete (archive) a member from a list
Inputs: list_id (required), email_address (required).
Batch add or remove members from a segment
Inputs: list_id (required), segment_id (required), members_to_add, members_to_remove.
Delete (unsubscribe and archive) a member from a list
Inputs: list_id (required), email_address (required).
Get information about a specific list member
Inputs: list_id (required), email_address (required).
Get recent activity for a specific list member
Inputs: list_id (required), email_address (required), count, offset.
Get recent goal events for a specific list member
Inputs: list_id (required), email_address (required).
Get all tags assigned to a member
Inputs: list_id (required), email_address (required).
Get all members (subscribers) in a list
Inputs: list_id (required), count, offset, status, +7 more.
Update an existing list member
Inputs: list_id (required), email_address (required), vip, status, +3 more.
Create a new merge field (custom field) for a list
Inputs: tag (required), name (required), type (required), list_id (required), +6 more.
Delete a merge field. Note: built-in fields (EMAIL, FNAME, LNAME) cannot be deleted.
Inputs: list_id (required), merge_id (required).
Get a specific merge field by ID
Inputs: list_id (required), merge_id (required).
Get all merge fields (custom fields) for a list/audience
Inputs: list_id (required), type, count, offset, +1 more.
Update an existing merge field
Inputs: list_id (required), merge_id (required), tag, name, +6 more.
Get a detailed campaign report
Inputs: campaign_id (required).
Get click details for a specific link in a campaign
Inputs: link_id (required), campaign_id (required).
Get detailed click reports for all links in a campaign
Inputs: campaign_id (required), count, offset.
Get top-performing email domains for a campaign
Inputs: campaign_id (required).
Get activity for a specific subscriber in a campaign
Inputs: campaign_id (required), email_address (required).
Get detailed open information for a campaign
Inputs: campaign_id (required), count, since, offset.
Get sub-reports for multivariate, RSS, or A/B test campaigns
Inputs: campaign_id (required).
Get campaign reports for your Mailchimp account
Inputs: type, count, offset, since_send_time, +1 more.
Search all campaigns in your account for specific query terms
Inputs: query (required), count, offset.
Search for members across all lists or a specific list
Inputs: query (required), count, offset, list_id.
Search for tags on a list by name
Inputs: name (required), list_id (required).
Create a new template
Inputs: html (required), name (required), folder_id.
Delete a template
Inputs: template_id (required).
Get information about a specific template
Inputs: template_id (required).
Get the default content for a template
Inputs: template_id (required).
Get all templates in your Mailchimp account
Inputs: type, count, offset, category, +6 more.
Update a template
Inputs: template_id (required), html, name, folder_id.
Create a new webhook for a list. Webhooks fire when subscribers are added, removed, or their info changes.
Inputs: url (required), list_id (required), events, sources.
Delete a webhook
Inputs: list_id (required), webhook_id (required).
Get details for a specific webhook
Inputs: list_id (required), webhook_id (required).
Get all webhooks for a specific list/audience
Inputs: list_id (required).
Update an existing webhook
Inputs: list_id (required), webhook_id (required), url, events, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 120 tools
The set contains multiple exact-purpose duplicates, such as mailchimp_lists_batch_subscribe vs mailchimp_audiences_batch_subscribe, mailchimp_lists_get_growth_history vs mailchimp_audiences_get_growth_history, and mailchimp_lists_get_segments vs mailchimp_audiences_get_segments. Members_delete and members_archive also have nearly identical descriptions, making tool selection highly ambiguous.
Most tools follow a mailchimp_<domain>_<resource>_<action> pattern and are consistently snake_case, but there are notable deviations: search_campaigns and search_members invert the verb placement, and lists/audiences are used interchangeably for the same underlying resource. Members_add_tags is also misnamed since it handles both adding and removing tags.
120 tools is far beyond the 50+ extreme threshold and creates an enormous navigation burden. Even with Mailchimp's broad API surface, the count is excessive and includes many redundant or near-duplicate tools.
Core areas like campaigns, lists, members, templates, landing pages, and ecommerce CRUD are well covered, but there are notable gaps: promo rules only have list, promo codes only have list/add, and automations lack update/delete lifecycle operations. These gaps require agents to work around missing functionality.
Hosted Mailchimp MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Mailchimp MCP Pack — manage audiences, campaigns, and members via Mailchimp Marketing API.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows