mailchimp-mcp-alien-lifestyles
Provides tools for managing Mailchimp audiences, campaigns, members, templates, and other marketing resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mailchimp-mcp-alien-lifestyles list my audiences"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 informationReview 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
Option 1: macOS Installer App (Recommended for macOS)
Download the DMG file from GitHub Releases:
Download
MailchimpMCPInstaller.dmgOpen the DMG file
Double-click
MailchimpMCPInstaller.appFollow the installation wizard
Enter your Mailchimp API key when prompted
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 | bashFor All Platforms (using npx):
npx -y @alien-lifestyles/mailchimp-mcp mailchimp-mcp-installManual Install:
npm install -g @alien-lifestyles/mailchimp-mcp && mailchimp-mcp-setup📝 Step-by-Step Installation
Step 1: Install
npm install -g @alien-lifestyles/mailchimp-mcpStep 2: Run Setup
mailchimp-mcp-setupOr if installed locally:
npm run setupStep 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=trueThen manually edit Claude Desktop config at:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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 |
| Test connection |
| List all audiences |
| Get audience details |
| List members in audience |
| Get member details |
| List campaigns |
| Get campaign details |
| Get campaign analytics |
| Get account information |
| List verified domains |
| Get domain auth status |
Write Tools (Paid Only)
Tool | Description |
Campaigns | |
| Create new campaign |
| Update campaign settings |
| Set campaign content |
| Send campaign |
| Delete campaign |
Templates | |
| Create template with MTL validation |
| Update template |
| Delete template |
Files & Folders | |
| Upload file to File Manager |
| Delete file from File Manager |
| Create template folder |
| Delete template folder |
| Create file folder |
| Delete file folder |
Audiences | |
| Create new audience |
| Update audience settings |
| Delete audience |
Members | |
| Add member to audience |
| Update member information |
| Delete member from audience |
Segments | |
| Create segment |
| Update segment |
| Delete segment |
Tags | |
| Create tag |
| Add/remove tags from member |
| Delete tag |
Merge Fields | |
| Create merge field |
| Update merge field |
| Delete merge field |
Domains | |
| Add domain for verification |
| Delete verified domain |
| Send domain verification email |
E-commerce Stores | |
| 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 (with datacenter suffix) | Yes | - |
| Datacenter prefix (e.g., | Yes |
|
| License key for paid version | No | - |
| Enable read-only mode | No |
|
| Mask email addresses and PII | No |
|
Troubleshooting
API Key Invalid
Verify API key is correct and active in Mailchimp
Ensure datacenter prefix matches (e.g.,
us9in key andMAILCHIMP_SERVER_PREFIX)Use full, unmasked API key including datacenter suffix
Claude Desktop Connection Issues
Verify paths in
claude_desktop_config.jsonare correctEnsure
dist/index.jsexists (runnpm 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
.envfileEnable 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 toolsmc_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
Scored across 50 tools
Each tool targets a distinct resource (e.g., account, audience, campaign, automation) with clear get/list verbs, eliminating ambiguity.
All tools follow a strict 'mc_verbResource' pattern with PascalCase (e.g., mc_getAccount, mc_listAudiences), perfectly consistent.
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.
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
Mailchimp engagement intelligence for AI agents: campaign analytics and audience insights.
Hosted Mailchimp MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Email marketing in Claude or ChatGPT: draft, preview and send campaigns. You approve every send.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Related MCP Servers
- AlicenseAqualityCmaintenanceMailchimp MCP Server - Access Mailchimp data from Claude via MCP.100353 PyPI25MIT
- FlicenseNot gradedqualityDmaintenanceIntegrates Mailchimp with GenAI applications via the Model Context Protocol, enabling email marketing automation through natural language interactions.2-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with the Mailchimp API for managing campaigns, lists, templates, reports, and automations through natural language.3-
- AlicenseNot gradedqualityCmaintenanceManage Mailchimp audiences, campaigns, and members via the Mailchimp Marketing API through natural language queries.88 npmMIT