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:

``json
{
"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):

$3

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

$3

- List Automation Emails - Get all emails in an automation
- Get Automation Email - Retrieve details of a specific email

$3

- List Automation Subscribers - View subscribers in automation queue
- Get Automation Queue - Get the automation email queue

$3

- List Lists - Get all lists in your account
- Get List - Retrieve details of a specific list

$3

- List Campaigns - Get all campaigns in your account
- Get Campaign - Retrieve details of a specific campaign

$3

- List Members - Get all members in a specific list
- Get Member - Retrieve details of a specific member

$3

- List Segments - Get all segments in a specific list
- Get Segment - Retrieve details of a specific segment

$3

- List Templates - Get all templates in your account
- Get Template - Retrieve details of a specific template

$3

- 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

$3

- Get Account - Get account information and statistics

$3

- List Folders - Get all campaign folders
- Get Folder - Retrieve details of a specific folder

$3

- List Files - Get all files in the File Manager
- Get File - Retrieve details of a specific file

$3

- List Landing Pages - Get all landing pages
- Get Landing Page - Retrieve details of a specific landing page

$3

- 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

$3

- List Conversations - Get all conversations
- Get Conversation - Retrieve details of a specific conversation

$3

- 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:
`bash
npm install
`
3. Build the project:
`bash
npm run build
`

$3

Set the following environment variable:

`bash
MAILCHIMP_API_KEY=your-mailchimp-api-key-here
`

Your Mailchimp API key should include the data center suffix (e.g., xxxxxxxxxxxxxxxx-us1).

$3

#### Automation Management

##### list_automations

Lists all automations in your Mailchimp account.

`typescript
// No parameters required
`

##### get_automation

Get details of a specific automation by workflow ID.

`typescript
{
workflow_id: string; // Required: The workflow ID of the automation
}
`

#### Automation Email Management

##### list_automation_emails

List all emails in an automation.

`typescript
{
workflow_id: string; // Required: The workflow ID
}
`

##### get_automation_email

Get details of a specific email in an automation.

`typescript
{
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.

`typescript
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
`

##### get_automation_queue

Get the automation email queue.

`typescript
{
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.

`typescript
// No parameters required
`

##### get_list

Get details of a specific list.

`typescript
{
list_id: string; // Required: The list ID
}
`

#### Campaign Management

##### list_campaigns

List all campaigns in your Mailchimp account.

`typescript
// No parameters required
`

##### get_campaign

Get details of a specific campaign.

`typescript
{
campaign_id: string; // Required: The campaign ID
}
`

#### Member Management

##### list_members

List all members in a specific list.

`typescript
{
list_id: string; // Required: The list ID
}
`

##### get_member

Get details of a specific member.

`typescript
{
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.

`typescript
{
list_id: string; // Required: The list ID
}
`

##### get_segment

Get details of a specific segment.

`typescript
{
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.

`typescript
// No parameters required
`

##### get_template

Get details of a specific template.

`typescript
{
template_id: number; // Required: The template ID
}
`

#### Reports and Analytics

##### get_automation_report

Get automation report data.

`typescript
{
workflow_id: string; // Required: The workflow ID
}
`

##### get_automation_email_report

Get automation email report data.

`typescript
{
workflow_id: string; // Required: The workflow ID
email_id: string; // Required: The email ID
}
`

##### get_subscriber_activity

Get subscriber activity for an automation email.

`typescript
{
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.

`typescript
// No parameters required
`

##### get_campaign_report

Get detailed report for a specific campaign.

`typescript
{
campaign_id: string; // Required: The campaign ID
}
`

#### Account Information

##### get_account

Get account information.

`typescript
// No parameters required
`

#### Folder Management

##### list_folders

List all campaign folders.

`typescript
// No parameters required
`

##### get_folder

Get details of a specific folder.

`typescript
{
folder_id: string; // Required: The folder ID
}
`

#### File Manager

##### list_files

List all files in the File Manager.

`typescript
// No parameters required
`

##### get_file

Get details of a specific file.

`typescript
{
file_id: string; // Required: The file ID
}
`

#### Landing Pages

##### list_landing_pages

List all landing pages.

`typescript
// No parameters required
`

##### get_landing_page

Get details of a specific landing page.

`typescript
{
page_id: string; // Required: The landing page ID
}
`

#### E-commerce

##### list_stores

List all e-commerce stores.

`typescript
// No parameters required
`

##### get_store

Get details of a specific store.

`typescript
{
store_id: string; // Required: The store ID
}
`

##### list_products

List all products in a store.

`typescript
{
store_id: string; // Required: The store ID
}
`

##### get_product

Get details of a specific product.

`typescript
{
store_id: string; // Required: The store ID
product_id: string; // Required: The product ID
}
`

##### list_orders

List all orders in a store.

`typescript
{
store_id: string; // Required: The store ID
}
`

##### get_order

Get details of a specific order.

`typescript
{
store_id: string; // Required: The store ID
order_id: string; // Required: The order ID
}
`

#### Conversations

##### list_conversations

List all conversations.

`typescript
// No parameters required
`

##### get_conversation

Get details of a specific conversation.

`typescript
{
conversation_id: string; // Required: The conversation ID
}
`

#### Merge Fields

##### list_merge_fields

List all merge fields in a specific list.

`typescript
{
list_id: string; // Required: The list ID
}
`

##### get_merge_field

Get details of a specific merge field.

`typescript
{
list_id: string; // Required: The list ID
merge_field_id: number; // Required: The merge field ID
}
`

Development

$3

`bash
npm run build
`

$3

`bash
npm test
`

$3

`bash
npm run watch
`

$3

`bash
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.