Mailchimp MCP Server

Mailchimp MCP Server

Complete Model Context Protocol (MCP) server for Mailchimp Marketing API v3.0 with 104+ tools and 15+ React UI apps.

🚀 Features

104+ MCP Tools

Comprehensive coverage of the Mailchimp Marketing API v3.0:

• Campaigns (15 tools): Create, manage, send, schedule, and test email campaigns
• Lists/Audiences (14 tools): Manage lists, segments, interest categories, and growth analytics
• Members (12 tools): Add, update, tag, and track list subscribers
• Ecommerce (28 tools): Manage stores, products, orders, carts, customers, and promo codes
• Automations (10 tools): Manage automation workflows and emails
• Reports (8 tools): Access campaign analytics, click tracking, and performance data
• Landing Pages (8 tools): Create and manage landing pages
• Templates (6 tools): Manage email templates
• Search (2 tools): Search campaigns and members
• Tags (1 tool): Search and manage tags

15+ React UI Apps

Beautiful, dark-themed React applications for visual interaction:

1. Campaign Dashboard - View and manage all campaigns
2. Audience Manager - Comprehensive audience/list management
3. Subscriber Grid - Searchable subscriber table
4. Segment Builder - Create and manage segments
5. Template Gallery - Browse and use email templates
6. Automation Flow - Manage automation workflows
7. Campaign Analytics - Detailed campaign performance metrics
8. A/B Test Results - Compare A/B test outcomes
9. Email Preview - Preview campaign emails
10. Tag Manager - Organize and apply tags
11. Landing Page Builder - Create landing pages
12. Content Manager - Manage email content
13. Growth Chart - Visualize audience growth over time
14. Send Time Optimizer - Find optimal send times
15. List Health Monitor - Track list health metrics
16. Ecommerce Dashboard - Manage stores and products
17. Promo Code Manager - Create and track promo codes

📦 Installation

npm install
npm run build

🔧 Configuration

Set your Mailchimp API key as an environment variable:

export MAILCHIMP_API_KEY="your-api-key-us19"

Your API key format: xxxxxxxxxxxxxxxxxxxxx-datacenter (e.g., abc123-us19)

You can obtain your API key from: Mailchimp Account → Extras → API Keys

🎯 Usage

As MCP Server

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/path/to/servers/mailchimp/dist/index.js"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-us19"
      }
    }
  }
}

Standalone

npm start

📚 API Coverage

Campaign Management

• Create campaigns (regular, A/B split, RSS, variate)
• Set HTML/template content
• Send, schedule, pause, resume campaigns
• Send test emails
• Replicate campaigns
• Get send checklist

Audience/List Management

• Create and manage audiences
• Add/update/remove members (batch operations supported)
• Create segments (static, saved, fuzzy)
• Manage interest categories and groups
• Track growth history

Member Management

• Add/update members with merge fields
• Tag management (add/remove tags)
• Track member activity and goals
• Bulk subscribe operations
• VIP member designation

Automation Workflows

• List all automations
• Pause/start workflows
• Manage automation emails
• Queue management

Analytics & Reports

• Campaign performance reports
• Click-through tracking
• Open rate details
• Domain performance analysis
• A/B test results
• Email activity per subscriber

E-commerce

• Store management
• Product catalog (variants, SKUs, inventory)
• Order tracking
• Cart abandonment
• Customer management
• Promo rules and codes

Templates & Landing Pages

• Template gallery
• Create custom templates
• Landing page builder
• Publish/unpublish pages

🎨 React Apps

All apps use a consistent dark theme with Tailwind CSS:

• Background: bg-gray-900
• Cards: bg-gray-800 with border-gray-700
• Accents: Blue (blue-400, blue-600) and Green (green-400, green-600)
• Typography: White text with gray variants for hierarchy

Running Individual Apps

cd src/ui/react-app/campaign-dashboard
npm install
npm run dev

🔐 Authentication

The server uses HTTP Basic authentication with Mailchimp's API:

• Username: anystring (Mailchimp ignores this)
• Password: Your API key

⚡ Rate Limiting

Mailchimp enforces rate limits (typically 10 requests/second). The client automatically:

• Tracks rate limit headers
• Waits when limit is reached
• Resumes after reset time

📖 Tool Examples

Create a Campaign

{
  "type": "regular",
  "recipients": {
    "list_id": "abc123"
  },
  "settings": {
    "subject_line": "Welcome to our newsletter!",
    "from_name": "Your Company",
    "reply_to": "hello@yourcompany.com",
    "title": "Welcome Campaign"
  }
}

Add a Subscriber

{
  "list_id": "abc123",
  "email_address": "subscriber@example.com",
  "status": "subscribed",
  "merge_fields": {
    "FNAME": "John",
    "LNAME": "Doe"
  }
}

Get Campaign Report

{
  "campaign_id": "abc123"
}

🧪 Testing

npm run typecheck  # TypeScript type checking
npm test          # Run tests (if configured)

🏗️ Architecture

mailchimp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── clients/
│   │   └── mailchimp.ts      # Mailchimp API client
│   ├── tools/
│   │   ├── campaigns-tools.ts
│   │   ├── lists-tools.ts
│   │   ├── members-tools.ts
│   │   ├── automations-tools.ts
│   │   ├── templates-tools.ts
│   │   ├── reports-tools.ts
│   │   ├── landing-pages-tools.ts
│   │   ├── ecommerce-tools.ts
│   │   ├── tags-tools.ts
│   │   └── search-tools.ts
│   ├── types/
│   │   └── index.ts          # TypeScript type definitions
│   └── ui/
│       └── react-app/        # 15+ React applications
│           ├── campaign-dashboard/
│           ├── audience-manager/
│           ├── subscriber-grid/
│           └── ... (12+ more apps)
├── dist/                     # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

📄 License

MIT

🤝 Contributing

Contributions welcome! Please read our contributing guidelines and submit PRs.

📞 Support

• Mailchimp API Documentation
• MCP Documentation
• Issues: GitHub Issues

🔗 Related

• Mailchimp Marketing API v3.0
• Model Context Protocol
• MCPEngine

---

Built with ❤️ for the MCP community