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.