Mailchimp MCP Server
by AgentX-ai
README.md
# Mailchimp MCP Server
[](https://www.npmjs.com/package/@agentx-ai/mailchimp-mcp-server)
[](https://youtu.be/YcUrRAnFp8Q)
[](https://www.agentx.so/mcp/mailchimp)
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):
### Automation Management
**Note about automations:** These endpoints are for classic automations, not automation flows. Unfortunately those are not available in the [Mailchimp API](https://mailchimp.com/developer/marketing/api/customer-journeys-journeys-steps-actions/) 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:
```bash
npm install
```
3. Build the project:
```bash
npm run build
```
### Configuration
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`).
### Available Tools
#### 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
### Building
```bash
npm run build
```
### Testing
```bash
npm test
```
### Development Mode
```bash
npm run watch
```
### Inspector
```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.
TDQS
B3/5.0
Scored across 38 tools
Disambiguation5/5
Every tool has a clearly distinct purpose targeting specific resources and actions. The naming convention makes it immediately clear whether a tool retrieves a single item (get_*) or lists multiple items (list_*), with no ambiguity between similar operations.
Naming Consistency5/5
The naming follows a perfect and predictable pattern throughout: all tools use snake_case with consistent verb_noun combinations (get_resource for single items, list_resources for collections). There are no deviations or mixed conventions.
Tool Count2/5
With 38 tools, this is too many for typical MCP server purposes. While Mailchimp has many resources, the tool surface feels heavy and could overwhelm agents. A more focused subset would likely be more manageable and appropriate.
Completeness3/5
The surface provides extensive read-only coverage (get and list operations) but lacks create, update, or delete operations for most resources. While agents can retrieve data, they cannot modify Mailchimp resources, creating significant workflow gaps.
Maintenance
ActivityInactive
ResponsivenessUnresponsive