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

1. Clone this repository
2. Install dependencies:

   npm install
   

3. 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.