Skip to main content
Node.js

Mailchimp

v1.0.0
20

@half2me/mailchimp-mcp-server

MCP server for Mailchimp Marketing API with 100+ tools for managing audiences, campaigns, subscribers, templates, automations, and more.

nodeMIT

README

Mailchimp MCP Server

An MCP (Model Context Protocol) server that lets Claude interact with the Mailchimp Marketing API. Built for use with Claude Cowork and Claude Code.

Features

100+ tools across 17 categories:

  • Account: Ping / health check, account info
  • Audiences: List, get details, create, update, growth history, locations, email client stats
  • Subscribers: List, search, get, add/update, batch subscribe, archive, unsubscribe, manage tags, activity, notes, merge fields, interest categories, permanent delete
  • Campaigns: List, get details, create, update, cancel, set/get content, send, schedule, unschedule, replicate, test email, send checklist, search, delete
  • Campaign Feedback: List, add, update, delete feedback comments
  • Templates: List, get details, get HTML content, create, update, delete
  • Reports: List reports, detailed report, click details, open details, email activity, unsubscribes, domain performance, sent-to, A/B test results
  • Automations: List, get details, list emails, start/pause all, start/pause individual emails, email queue, remove subscriber
  • Customer Journeys: Trigger journey steps for contacts
  • Segments: List, get details, create, update, delete, list members
  • Ecommerce: Stores, products, product details, orders, order details, customers, carts, promo codes
  • Landing Pages: List, get details, create, update, delete, publish, unpublish
  • Webhooks: List, create, update, delete
  • File Manager: List files, get file, upload, delete, list folders, create folder
  • Batch Operations: Create batch, get status, list batches
  • Verified Domains: List, add, verify, delete sending domains
  • Activity Feed: Account-wide activity feed

Setup

1. Get Your Mailchimp API Key

  1. Log in to Mailchimp
  2. Click your profile icon → Account & billing
  3. Go to ExtrasAPI keys
  4. Click Create A Key
  5. Give it a name (e.g., "Claude Cowork") and copy the key

The key looks like: abc123def456ghi789-us21

The part after the dash (us21) is your data center — the server uses this automatically.

2. Build the Server

cd mailchimp-mcp-server
npm install
npm run build

3. Configure Claude

For Claude Desktop / Cowork

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mailchimp-mcp-server/dist/index.js"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace /FULL/PATH/TO/ with the actual absolute path to this folder, and paste your real API key.

For Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/FULL/PATH/TO/mailchimp-mcp-server/dist/index.js"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Restart Claude

After saving the config, restart Claude Desktop (or reload Claude Code) so it picks up the new MCP server.

Available Tools

Account (2)

ToolDescription
mailchimp_pingCheck API connection is working
mailchimp_get_accountGet account info, plan, and stats

Audiences (7)

ToolDescription
mailchimp_list_audiencesList all audiences with stats
mailchimp_get_audienceGet audience details
mailchimp_create_audienceCreate a new audience
mailchimp_update_audienceUpdate audience settings
mailchimp_get_audience_growthGet monthly growth history
mailchimp_get_audience_locationsGet geographic subscriber breakdown
mailchimp_get_email_client_statsGet email client usage stats

Subscribers (17)

ToolDescription
mailchimp_list_subscribersList subscribers (filter by status)
mailchimp_search_subscribersSearch by email or name
mailchimp_get_subscriberGet subscriber details
mailchimp_add_subscriberAdd or update subscriber (upsert)
mailchimp_batch_subscribeBatch subscribe/unsubscribe members
mailchimp_archive_subscriberArchive a subscriber
mailchimp_unsubscribeUnsubscribe a member
mailchimp_manage_tagsAdd/remove tags on a subscriber
mailchimp_get_subscriber_activityGet subscriber's recent activity
mailchimp_list_subscriber_notesList notes on a subscriber
mailchimp_add_subscriber_noteAdd a note to a subscriber
mailchimp_delete_subscriber_permanentPermanently delete a subscriber
mailchimp_list_merge_fieldsList custom fields for an audience
mailchimp_create_merge_fieldCreate a custom merge field
mailchimp_list_interest_categoriesList interest categories (groups)
mailchimp_list_interestsList interests in a category
mailchimp_search_tagsSearch tags in an audience

Campaigns (15)

ToolDescription
mailchimp_list_campaignsList campaigns with filters
mailchimp_get_campaignGet campaign details
mailchimp_create_campaignCreate a draft campaign
mailchimp_update_campaignUpdate campaign settings
mailchimp_set_campaign_contentSet campaign HTML/text content
mailchimp_get_campaign_contentGet campaign content
mailchimp_send_campaignSend a campaign immediately
mailchimp_schedule_campaignSchedule a campaign
mailchimp_unschedule_campaignCancel a scheduled campaign
mailchimp_cancel_campaignCancel a sending campaign
mailchimp_send_test_emailSend a test email preview
mailchimp_get_send_checklistReview send readiness checklist
mailchimp_replicate_campaignDuplicate a campaign
mailchimp_search_campaignsSearch campaigns by title/subject
mailchimp_delete_campaignDelete a draft campaign

Campaign Feedback (4)

ToolDescription
mailchimp_list_campaign_feedbackList feedback comments on a campaign
mailchimp_add_campaign_feedbackAdd a feedback comment
mailchimp_update_campaign_feedbackUpdate or resolve feedback
mailchimp_delete_campaign_feedbackDelete a feedback comment

Templates (6)

ToolDescription
mailchimp_list_templatesList email templates
mailchimp_get_templateGet template metadata
mailchimp_get_template_contentGet template HTML content
mailchimp_create_templateCreate a template
mailchimp_update_templateUpdate template name or HTML
mailchimp_delete_templateDelete a template

Reports (9)

ToolDescription
mailchimp_list_reportsList campaign reports
mailchimp_get_reportGet detailed campaign report
mailchimp_get_click_detailsGet URL click details
mailchimp_get_open_detailsGet subscriber open data
mailchimp_get_email_activityGet per-subscriber activity log
mailchimp_get_unsubscribesList campaign unsubscribes
mailchimp_get_domain_performanceEmail domain performance stats
mailchimp_get_sent_toList sent-to recipients
mailchimp_get_ab_test_resultsGet A/B test results

Automations (10)

ToolDescription
mailchimp_list_automationsList automation workflows
mailchimp_get_automationGet automation details
mailchimp_list_automation_emailsList emails in an automation
mailchimp_start_automationStart all emails in an automation
mailchimp_pause_automationPause all emails in an automation
mailchimp_start_automation_emailStart a specific automation email
mailchimp_pause_automation_emailPause a specific automation email
mailchimp_list_automation_queueList subscribers in email queue
mailchimp_remove_automation_subscriberRemove subscriber from automation

Customer Journeys (1)

ToolDescription
mailchimp_trigger_journey_stepTrigger a journey step for a contact

Segments (6)

ToolDescription
mailchimp_list_segmentsList segments for an audience
mailchimp_get_segmentGet segment details and conditions
mailchimp_create_segmentCreate a segment (static or saved)
mailchimp_update_segmentUpdate segment name or members
mailchimp_delete_segmentDelete a segment
mailchimp_list_segment_membersList members in a segment

Ecommerce (9)

ToolDescription
mailchimp_list_ecommerce_storesList connected stores
mailchimp_list_store_productsList products in a store
mailchimp_get_store_productGet product details with variants
mailchimp_list_store_ordersList orders (filter by campaign)
mailchimp_get_store_orderGet order details with line items
mailchimp_list_store_customersList store customers
mailchimp_get_ecommerce_customerGet customer details
mailchimp_list_store_cartsList abandoned carts
mailchimp_list_store_promo_codesList promo codes for a rule

Landing Pages (7)

ToolDescription
mailchimp_list_landing_pagesList all landing pages
mailchimp_get_landing_pageGet landing page details
mailchimp_create_landing_pageCreate a landing page
mailchimp_update_landing_pageUpdate a landing page
mailchimp_delete_landing_pageDelete a landing page
mailchimp_publish_landing_pagePublish a landing page
mailchimp_unpublish_landing_pageUnpublish a landing page

Webhooks (4)

ToolDescription
mailchimp_list_webhooksList webhooks for an audience
mailchimp_create_webhookCreate a webhook
mailchimp_update_webhookUpdate a webhook
mailchimp_delete_webhookDelete a webhook

File Manager (6)

ToolDescription
mailchimp_list_filesList files in file manager
mailchimp_get_fileGet file details
mailchimp_upload_fileUpload a file (base64)
mailchimp_delete_fileDelete a file
mailchimp_list_file_foldersList file manager folders
mailchimp_create_file_folderCreate a folder

Batch Operations (3)

ToolDescription
mailchimp_create_batchCreate a batch operation (up to 500 ops)
mailchimp_get_batch_statusGet batch operation status
mailchimp_list_batchesList batch operations

Verified Domains (4)

ToolDescription
mailchimp_list_verified_domainsList verified sending domains
mailchimp_add_verified_domainAdd a domain to verify
mailchimp_verify_domainSubmit verification code
mailchimp_delete_verified_domainRemove a verified domain

Activity Feed (1)

ToolDescription
mailchimp_get_activity_feedGet account-wide activity feed