Mailchimp MCP Server
A Model Context Protocol (MCP) server that provides read-only access to Mailchimp's Marketing API for comprehensive email marketing data retrieval.
Usage
The server can be used with any MCP client. Configure your client to use:
{
"mcpServers": {
"mailchimp": {
"command": "npx",
"args": ["@agentx-ai/mailchimp-mcp-server"],
"env": {
"MAILCHIMP_API_KEY": "your-api-key-here"
}
}
}
}
Features
This MCP server supports the following Mailchimp Marketing API endpoints (read-only operations):
Automation Management
Note about automations: These endpoints are for classic automations, not automation flows. Unfortunately those are not available in the Mailchimp API as of yet.
- List Automations - Get all automations in your account
- Get Automation - Retrieve details of a specific automation
Automation Email Management
- List Automation Emails - Get all emails in an automation
- Get Automation Email - Retrieve details of a specific email
Subscriber Management
- List Automation Subscribers - View subscribers in automation queue
- Get Automation Queue - Get the automation email queue
List Management
- List Lists - Get all lists in your account
- Get List - Retrieve details of a specific list
Campaign Management
- List Campaigns - Get all campaigns in your account
- Get Campaign - Retrieve details of a specific campaign
Member Management
- List Members - Get all members in a specific list
- Get Member - Retrieve details of a specific member
Segment Management
- List Segments - Get all segments in a specific list
- Get Segment - Retrieve details of a specific segment
Template Management
- List Templates - Get all templates in your account
- Get Template - Retrieve details of a specific template
Reports and Analytics
- Get Automation Report - Get automation report data
- Get Automation Email Report - Get automation email report data
- Get Subscriber Activity - Get subscriber activity for an automation email
- List Campaign Reports - Get all campaign reports
- Get Campaign Report - Get detailed report for a specific campaign
Account Information
- Get Account - Get account information and statistics
Folder Management
- List Folders - Get all campaign folders
- Get Folder - Retrieve details of a specific folder
File Manager
- List Files - Get all files in the File Manager
- Get File - Retrieve details of a specific file
Landing Pages
- List Landing Pages - Get all landing pages
- Get Landing Page - Retrieve details of a specific landing page
E-commerce
- List Stores - Get all e-commerce stores
- Get Store - Retrieve details of a specific store
- List Products - Get all products in a store
- Get Product - Retrieve details of a specific product
- List Orders - Get all orders in a store
- Get Order - Retrieve details of a specific order
Conversations
- List Conversations - Get all conversations
- Get Conversation - Retrieve details of a specific conversation
Merge Fields
- List Merge Fields - Get all merge fields in a specific list
- Get Merge Field - Retrieve details of a specific merge field
Local Installation
- Clone this repository
- Install dependencies:
npm install - Build the project:
npm run build
Configuration
Set the following environment variable:
MAILCHIMP_API_KEY=your-mailchimp-api-key-here
Your Mailchimp API key should include the data center suffix (e.g., xxxxxxxxxxxxxxxx-us1).
Available Tools
Automation Management
list_automations
Lists all automations in your Mailchimp account.
// No parameters required
get_automation
Get details of a specific automation by workflow ID.
{
workflow_id: string; // Required: The workflow ID of the automation
}
Automation Email Management
list_automation_emails
List all emails in an automation.
{
workflow_id: string; // Required: The workflow ID
}
get_automation_email
Get details of a specific email in an automation.
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
Subscriber Management
list_automation_subscribers
List subscribers in an automation email queue.
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
get_automation_queue
Get the automation email queue.
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
List Management
list_lists
List all lists in your Mailchimp account.
// No parameters required
get_list
Get details of a specific list.
{
list_id: string; // Required: The list ID
}
Campaign Management
list_campaigns
List all campaigns in your Mailchimp account.
// No parameters required
get_campaign
Get details of a specific campaign.
{
campaign_id: string; // Required: The campaign ID
}
Member Management
list_members
List all members in a specific list.
{
list_id: string; // Required: The list ID
}
get_member
Get details of a specific member.
{
list_id: string; // Required: The list ID
subscriber_hash: string; // Required: The subscriber hash
}
Segment Management
list_segments
List all segments in a specific list.
{
list_id: string; // Required: The list ID
}
get_segment
Get details of a specific segment.
{
list_id: string; // Required: The list ID
segment_id: number; // Required: The segment ID
}
Template Management
list_templates
List all templates in your Mailchimp account.
// No parameters required
get_template
Get details of a specific template.
{
template_id: number; // Required: The template ID
}
Reports and Analytics
get_automation_report
Get automation report data.
{
workflow_id: string; // Required: The workflow ID
}
get_automation_email_report
Get automation email report data.
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
get_subscriber_activity
Get subscriber activity for an automation email.
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
subscriber_hash: string; // Required: The subscriber hash
}
list_campaign_reports
List all campaign reports.
// No parameters required
get_campaign_report
Get detailed report for a specific campaign.
{
campaign_id: string; // Required: The campaign ID
}
Account Information
get_account
Get account information.
// No parameters required
Folder Management
list_folders
List all campaign folders.
// No parameters required
get_folder
Get details of a specific folder.
{
folder_id: string; // Required: The folder ID
}
File Manager
list_files
List all files in the File Manager.
// No parameters required
get_file
Get details of a specific file.
{
file_id: string; // Required: The file ID
}
Landing Pages
list_landing_pages
List all landing pages.
// No parameters required
get_landing_page
Get details of a specific landing page.
{
page_id: string; // Required: The landing page ID
}
E-commerce
list_stores
List all e-commerce stores.
// No parameters required
get_store
Get details of a specific store.
{
store_id: string; // Required: The store ID
}
list_products
List all products in a store.
{
store_id: string; // Required: The store ID
}
get_product
Get details of a specific product.
{
store_id: string; // Required: The store ID
product_id: string; // Required: The product ID
}
list_orders
List all orders in a store.
{
store_id: string; // Required: The store ID
}
get_order
Get details of a specific order.
{
store_id: string; // Required: The store ID
order_id: string; // Required: The order ID
}
Conversations
list_conversations
List all conversations.
// No parameters required
get_conversation
Get details of a specific conversation.
{
conversation_id: string; // Required: The conversation ID
}
Merge Fields
list_merge_fields
List all merge fields in a specific list.
{
list_id: string; // Required: The list ID
}
get_merge_field
Get details of a specific merge field.
{
list_id: string; // Required: The list ID
merge_field_id: number; // Required: The merge field ID
}
Development
Building
npm run build
Testing
npm test
Development Mode
npm run watch
Inspector
npm run inspector
API Reference
This MCP server implements read-only operations from the Mailchimp Marketing API v3. For detailed API documentation, visit: https://mailchimp.com/developer/marketing/api/
License
This project is licensed under the MIT License.