Mailchimp MCP Server

A Model Context Protocol (MCP) server for integrating Mailchimp with Claude Desktop.

⚠️ Security & Privacy Notice

IMPORTANT: This MCP server exposes personal data to Claude AI and Claude Desktop:

• Email addresses and member information are sent to Claude AI via tool responses

• Claude Desktop stores conversation history locally on your device

• Use only with accounts containing non-sensitive data

• Enable PII masking (MAILCHIMP_MASK_PII=true) to protect personal information

• Review SECURITY.md for detailed security information

Quick Start

💡 New to Mailchimp MCP? See INSTALL.md for detailed installation instructions and troubleshooting.

🚀 Installation Options

Option 1: macOS Installer App (Recommended for macOS)

Download the DMG file from GitHub Releases:

1. Download MailchimpMCPInstaller.dmg

2. Open the DMG file

3. Double-click MailchimpMCPInstaller.app

4. Follow the installation wizard

5. Enter your Mailchimp API key when prompted

6. Restart Claude Desktop

The installer will:

• ✅ Check prerequisites (Node.js, npm)

• ✅ Install the package globally

• ✅ Launch the setup UI in your browser

• ✅ Automatically configure Claude Desktop

• ✅ Validate that Claude Desktop will auto-start Mailchimp MCP

Uninstaller: The DMG also includes MailchimpMCPUninstaller.app to completely remove Mailchimp MCP and all associated data.

Option 2: Command Line (All Platforms)

For macOS:

curl -fsSL https://raw.githubusercontent.com/alien-lifestyles/mailchimp-mcp-alien-lifestyles/main/install.sh | bash

For All Platforms (using npx):

npx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-install

Manual Install:

npm install -g @alien-lifestyles/mailchimp-mcp && mailchimp-mcp-setup

📝 Step-by-Step Installation

Step 1: Install

npm install -g @alien-lifestyles/mailchimp-mcp

Step 2: Run Setup

mailchimp-mcp-setup

Or if installed locally:

npm run setup

Step 3: Configure

The setup UI will open in your browser at http://localhost:3000. Enter:

• ✅ Your Mailchimp API key (required)

• ✅ Server prefix (auto-detected from API key)

• ⭐ License key (optional - for paid features)

• 🔒 Privacy settings (PII masking recommended)

Step 4: Restart Claude Desktop

After saving your configuration, restart Claude Desktop completely for changes to take effect.

Step 5: Test

Ask Claude: "Can you run mc_ping?" to verify the connection.

🔧 Manual Configuration (Advanced)

If you prefer manual setup, create a .env file:

# Required
MAILCHIMP_API_KEY=your_api_key_here-us9
MAILCHIMP_SERVER_PREFIX=us9

# Optional
MAILCHIMP_LICENSE_KEY=ALIEN-XXXX-XXXX-XXXX
MAILCHIMP_MASK_PII=true

Then manually edit Claude Desktop config at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Add:

{
  "mcpServers": {
    "mailchimp-mcp": {
      "command": "node",
      "args": ["/path/to/@alien-lifestyles/mailchimp-mcp/dist/index.js"],
      "cwd": "/path/to/@alien-lifestyles/mailchimp-mcp",
      "env": {
        "MAILCHIMP_API_KEY": "your_api_key_here-us9",
        "MAILCHIMP_SERVER_PREFIX": "us9",
        "MAILCHIMP_MASK_PII": "true"
      }
    }
  }
}

Free vs Paid Versions

Free Version (Default)

• Read-only access to audiences, campaigns, reports

• 5 Marketer prompts

• No write operations

• No license key required

Paid Version

• Full read/write access

• All prompts (CSM, Marketer, Business Owner)

• Create campaigns, templates, audiences

• File Manager integration

• Requires license key from alienlifestyles.com

Available Tools

Read Tools

Write Tools (Paid Only)

Example Queries

• "List my Mailchimp audiences"

• "How many subscribers do I have?"

• "Show me my recent campaigns"

• "What's my top performing campaign?"

• "Check my domain authentication status"

See USE_CASES.md for more examples.

Environment Variables

Troubleshooting

API Key Invalid

• Verify API key is correct and active in Mailchimp

• Ensure datacenter prefix matches (e.g., us9 in key and MAILCHIMP_SERVER_PREFIX)

• Use full, unmasked API key including datacenter suffix

Claude Desktop Connection Issues

• Verify paths in claude_desktop_config.json are correct

• Ensure dist/index.js exists (run npm run build)

• Check Claude Desktop logs: Settings → Developer → View Logs

• Restart Claude Desktop after configuration changes

Development

npm run dev           # Development mode with watch
npm run build         # Build project
npm start             # Run built server
npm run setup         # Launch setup UI
npm run build:installer  # Build macOS installer and uninstaller apps (requires Xcode)

Security

• Never commit your .env file

• Enable PII masking (MAILCHIMP_MASK_PII=true)

• Use read-only API keys when possible

• Review SECURITY.md for comprehensive security documentation

• Claude Desktop stores conversation history locally

Contributing

Contributions welcome. Ensure code follows TypeScript best practices and includes proper input validation.

License

MIT

Support

• Check Troubleshooting section

• Review SECURITY.md

• Open an issue on GitHub