Skip to main content
Glama
mailchimp-mcp-alien-lifestyles

mailchimp-mcp-alien-lifestyles

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

Related MCP server: Mailchimp MCP Server

Quick Start

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

🚀 Installation Options

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

Tool

Description

mc_ping

Test connection

mc_listAudiences

List all audiences

mc_getAudience

Get audience details

mc_listMembers

List members in audience

mc_getMember

Get member details

mc_listCampaigns

List campaigns

mc_getCampaign

Get campaign details

mc_getCampaignReport

Get campaign analytics

mc_getAccount

Get account information

mc_listVerifiedDomains

List verified domains

mc_getVerifiedDomain

Get domain auth status

Write Tools (Paid Only)

Tool

Description

Campaigns

mc_createCampaign

Create new campaign

mc_updateCampaign

Update campaign settings

mc_setCampaignContent

Set campaign content

mc_sendCampaign

Send campaign

mc_deleteCampaign

Delete campaign

Templates

mc_createTemplate

Create template with MTL validation

mc_updateTemplate

Update template

mc_deleteTemplate

Delete template

Files & Folders

mc_uploadFile

Upload file to File Manager

mc_deleteFile

Delete file from File Manager

mc_createTemplateFolder

Create template folder

mc_deleteTemplateFolder

Delete template folder

mc_createFileFolder

Create file folder

mc_deleteFileFolder

Delete file folder

Audiences

mc_createAudience

Create new audience

mc_updateAudience

Update audience settings

mc_deleteAudience

Delete audience

Members

mc_createMember

Add member to audience

mc_updateMember

Update member information

mc_deleteMember

Delete member from audience

Segments

mc_createSegment

Create segment

mc_updateSegment

Update segment

mc_deleteSegment

Delete segment

Tags

mc_createTag

Create tag

mc_addTagToMember

Add/remove tags from member

mc_deleteTag

Delete tag

Merge Fields

mc_createMergeField

Create merge field

mc_updateMergeField

Update merge field

mc_deleteMergeField

Delete merge field

Domains

mc_createVerifiedDomain

Add domain for verification

mc_deleteVerifiedDomain

Delete verified domain

mc_sendDomainVerificationEmail

Send domain verification email

E-commerce Stores

mc_deleteStore

Delete e-commerce store (Note: Mailchimp Stores API is read-only - stores must be deleted via web interface)

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

Variable

Description

Required

Default

MAILCHIMP_API_KEY

Mailchimp API key (with datacenter suffix)

Yes

-

MAILCHIMP_SERVER_PREFIX

Datacenter prefix (e.g., us9)

Yes

us21

MAILCHIMP_LICENSE_KEY

License key for paid version

No

-

MAILCHIMP_READONLY

Enable read-only mode

No

true

MAILCHIMP_MASK_PII

Mask email addresses and PII

No

false

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

Available Tools

50 tools
mc_getAccountB

Get account information

Inputs: no named parameters.

mc_getAudienceC

Get audience details

Inputs: audienceId (required).

mc_getAutomationC

Get automation workflow details

Inputs: workflowId (required).

mc_getAutomationEmailC

Get automation email details

Inputs: workflowId (required), workflowEmailId (required).

mc_getBatchOperationC

Get batch operation details

Inputs: batchId (required).

mc_getCampaignC

Get campaign details

Inputs: campaignId (required).

mc_getCampaignContentC

Get campaign content

Inputs: campaignId (required).

mc_getCampaignReportC

Get campaign analytics report

Inputs: campaignId (required).

mc_getConversationC

Get conversation details

Inputs: conversationId (required).

mc_getFileC

Get file details

Inputs: fileId (required).

mc_getFileFolderB

Get file folder details

Inputs: folderId (required).

mc_getInterestC

Get interest details

Inputs: audienceId (required), interestId (required), interestCategoryId (required).

mc_getInterestCategoryC

Get interest category details

Inputs: audienceId (required), interestCategoryId (required).

mc_getMemberB

Get member details by email

Inputs: email (required), audienceId (required).

mc_getMergeFieldC

Get merge field details

Inputs: audienceId (required), mergeFieldId (required).

mc_getSegmentB

Get segment details

Inputs: segmentId (required), audienceId (required).

mc_getStoreB

Get e-commerce store details

Inputs: storeId (required).

mc_getStoreCustomerB

Get customer details

Inputs: storeId (required), customerId (required).

mc_getStoreOrderA

Get order details

Inputs: orderId (required), storeId (required).

mc_getStoreProductC

Get product details

Inputs: storeId (required), productId (required).

mc_getTagD

Get tag information

Inputs: tagId (required), audienceId (required).

mc_getTemplateC

Get template details

Inputs: templateId (required).

mc_getTemplateFolderC

Get template folder details

Inputs: folderId (required).

mc_getVerifiedDomainB

Get domain authentication status

Inputs: domainName (required).

mc_listAudienceActivityC

List activity feed for audience

Inputs: audienceId (required), count, offset.

mc_listAudiencesB

List Mailchimp audiences with member counts

Inputs: count, offset.

mc_listAutomationEmailsC

List emails in automation workflow

Inputs: workflowId (required).

mc_listAutomationsB

List automation workflows

Inputs: count, offset.

mc_listBatchOperationsC

List batch operations

Inputs: count, offset.

mc_listCampaignsC

List Mailchimp campaigns

Inputs: count, offset, status, since_send_time.

mc_listConversationMessagesC

List messages in conversation

Inputs: conversationId (required), count, offset.

mc_listConversationsC

List conversations

Inputs: count, offset, list_id, has_unread.

mc_listFileFoldersC

List folders in File Manager

Inputs: count, offset.

mc_listFilesC

List files in File Manager

Inputs: type, count, offset.

mc_listInterestCategoriesD

List interest categories

Inputs: audienceId (required), count, offset.

mc_listInterestsC

List interests in category

Inputs: audienceId (required), interestCategoryId (required), count, offset.

mc_listMembersB

List members in an audience

Inputs: audienceId (required), count, offset, status.

mc_listMergeFieldsB

List merge fields for audience

Inputs: audienceId (required), type, count, offset.

mc_listReportsC

List campaign reports

Inputs: count, offset, since_send_time, before_send_time.

mc_listSegmentMembersC

List members in segment

Inputs: segmentId (required), audienceId (required), count, offset.

mc_listSegmentsB

List segments for audience

Inputs: audienceId (required), type, count, offset.

mc_listStoreCustomersB

List customers from store

Inputs: storeId (required), count, offset.

mc_listStoreOrdersC

List orders from store

Inputs: storeId (required), count, offset, customer_id.

mc_listStoreProductsC

List products in store

Inputs: storeId (required), count, offset.

mc_listStoresC

List e-commerce stores

Inputs: count, offset.

mc_listTagsB

List tags for audience

Inputs: audienceId (required), count, offset.

mc_listTemplateFoldersC

List template folders

Inputs: count, offset.

mc_listTemplatesC

List email templates

Inputs: type, count, offset.

mc_listVerifiedDomainsB

List verified domains

Inputs: no named parameters.

mc_pingA

Test connection to Mailchimp MCP server

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 50 tools

    Disambiguation5/5

    Each tool targets a distinct resource (e.g., account, audience, campaign, automation) with clear get/list verbs, eliminating ambiguity.

    Naming Consistency5/5

    All tools follow a strict 'mc_verbResource' pattern with PascalCase (e.g., mc_getAccount, mc_listAudiences), perfectly consistent.

    Tool Count3/5

    50 tools is high, but acceptable for a comprehensive read-only API covering many Mailchimp resources. However, the lack of write operations makes the count feel inflated.

    Completeness2/5

    The tool set is entirely read-only (only get/list and ping). Missing all write operations (create, update, delete) for any resource, which is a severe gap for a Mailchimp API.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Mailchimp MCP Server - Access Mailchimp data from Claude via MCP.
      100
      353 PyPI
      25
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Integrates Mailchimp with GenAI applications via the Model Context Protocol, enabling email marketing automation through natural language interactions.
      2
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the Mailchimp API for managing campaigns, lists, templates, reports, and automations through natural language.
      3
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Manage Mailchimp audiences, campaigns, and members via the Mailchimp Marketing API through natural language queries.
      88 npm
      MIT