home / mcp / mailchimp mcp server

Mailchimp MCP Server

Allows AI agents to interact with the Mailchimp API (read-only)

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "agentx-ai-mailchimp-mcp": {
      "command": "npx",
      "args": [
        "@agentx-ai/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "your-mailchimp-api-key-here"
      }
    }
  }
}

You can access Mailchimp data through a dedicated MCP server that exposes read-only endpoints from Mailchimp Marketing API. This server lets you query automations, lists, campaigns, subscribers, reports, and a broad set of Mailchimp resources in a consistent MCP client workflow without building custom integration code.

How to use

Use this server with any MCP client by configuring it to point at the local or remote MCP instance. The server runs as a stdio MCP endpoint, so you start it as a local process and connect your client to it. You can read automation details, campaign data, subscriber information, and various Mailchimp resources in a structured, read-only fashion.

How to install

Prerequisites: You need Node.js and npm installed on your machine. Ensure you have a Mailchimp API key with access to the Marketing API.

# 1) Clone the repository that contains the MCP server
# (Replace with your actual clone command if different)
# git clone https://example.com/your-mcp-mailchimp-repo.git
# 2) Install dependencies
npm install
# 3) Build the project (if applicable)
npm run build
# 4) Start the MCP server (see configuration below)
npx @agentx-ai/mailchimp-mcp-server

Additional content

Configuration is driven by environment variables and MCP client configuration. The server requires your Mailchimp API key to authorize requests. You can also run the server via a local MCP command using npx, which keeps you in a simple, development-friendly workflow.

For local development, set the API key in your environment before starting the MCP server.

Available tools

list_automations

List all automations in your Mailchimp account. No parameters required.

get_automation

Get details of a specific automation by workflow ID.

list_automation_emails

List all emails in an automation.

get_automation_email

Get details of a specific automation email by workflow ID and email ID.

list_automation_subscribers

List subscribers in the automation email queue for a given workflow and email.

get_automation_queue

Get the automation email queue for a given workflow and email.

list_lists

List all lists in your Mailchimp account.

get_list

Get details of a specific list by list ID.

list_campaigns

List all campaigns in your Mailchimp account.

get_campaign

Get details of a specific campaign by campaign ID.

list_members

List all members in a specific list.

get_member

Get details of a specific member by list ID and subscriber hash.

list_segments

List all segments in a specific list.

get_segment

Get details of a specific segment by list ID and segment ID.

list_templates

List all templates in your Mailchimp account.

get_template

Get details of a specific template by template ID.

get_automation_report

Get automation report data for a given workflow.

get_automation_email_report

Get automation email report data for a given workflow and email.

get_subscriber_activity

Get subscriber activity for a specific automation email.

list_campaign_reports

List all campaign reports.

get_campaign_report

Get a detailed report for a specific campaign.

get_account

Get account information and statistics.

list_folders

List all campaign folders.

get_folder

Get details of a specific folder by folder ID.

list_files

List all files in the File Manager.

get_file

Get details of a specific file by file ID.

list_landing_pages

List all landing pages.

get_landing_page

Get details of a specific landing page by page ID.

list_stores

List all e-commerce stores.

get_store

Get details of a specific store by store ID.

list_products

List all products in a store.

get_product

Get details of a specific product by store ID and product ID.

list_orders

List all orders in a store.

get_order

Get details of a specific order by store ID and order ID.

list_conversations

List all conversations.

get_conversation

Get details of a specific conversation by conversation ID.

list_merge_fields

List all merge fields in a specific list.

get_merge_field

Get details of a specific merge field by list ID and merge field ID.