mailchimp-mcp-server MCP Server

The most complete Model Context Protocol (MCP) server for the Mailchimp Marketing API: 227 tools to query and manage your Mailchimp account from any MCP-compatible client. It covers the full…

Local serverstdio

What is the mailchimp-mcp-server MCP Server?

mailchimp-mcp-server is an MCP project maintained in the damientilman/mailchimp-mcp-server repository. The maintainer describes its purpose as “The most complete Model Context Protocol (MCP) server for the Mailchimp Marketing API: 227 tools to query and manage your Mailchimp account from any MCP-compatible…”. Read the project documentation for the complete scope.

Installation

The documented pypi package is mailchimp-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares MAILCHIMP_API_KEY, MAILCHIMP_READ_ONLY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
readreporting and analytics only (~115 tools, ~29k tokens). A safe, lightweight default for exploration.
get_account_infoGet account name, email, and subscriber count
list_accountsList configured accounts and their read-only / dry-run state (for multi-account setups)
describe_toolsList every tool with its risk tier (read / write / destructive) for policy enforcement
list_campaignsList campaigns with optional filters (status, date)
get_campaign_detailsGet full details of a specific campaign
list_campaign_foldersList campaign folders
get_campaign_reportGet performance metrics (opens, clicks, bounces)
get_campaign_click_detailsGet per-link click data for a campaign
get_email_activityPer-recipient activity (opens, clicks, bounces)
get_open_detailsWho opened, when, how many times
get_campaign_recipientsList of recipients with delivery status
get_campaign_unsubscribesWho unsubscribed after a campaign
get_domain_performancePerformance by email domain (gmail, outlook, etc.)
get_ecommerce_product_activityRevenue per product for a campaign
get_campaign_sub_reportsSub-reports (A/B tests, RSS, etc.)
get_campaign_adviceMailchimp's automated post-send feedback on a campaign
get_campaign_locationsGeographic open data (country, region)
get_eepurl_activitySocial sharing stats (Twitter, Facebook, referrers)
create_campaignCreate a new campaign draft (regular or A/B variate, with optional segment targeting)
update_campaignUpdate settings or segment targeting of a campaign
set_campaign_contentSet the HTML content of a campaign draft
schedule_campaignSchedule a campaign for a specific date/time
unschedule_campaignUnschedule a campaign (back to draft)
replicate_campaignDuplicate an existing campaign
delete_campaignDelete an unsent campaign
send_campaignSend a campaign immediately
send_test_emailSend a test email for a campaign
cancel_sendCancel a campaign that is currently sending
list_audiencesList all audiences with stats, opt-in mode, GDPR flag, and sender defaults
get_audience_detailsGet detailed info for a specific audience
list_audience_membersList members with optional status filter
search_membersSearch members by email or name
get_audience_growth_historyMonthly growth data (subscribes, unsubscribes)
get_member_activityActivity history of a specific contact
get_member_tagsAll tags assigned to a contact
get_member_eventsCustom events for a contact
list_member_notesList CRM-style internal notes attached to a contact
add_memberAdd a new contact to an audience
update_memberUpdate a contact's name or status
unsubscribe_memberUnsubscribe a contact
delete_memberPermanently delete a contact
tag_memberAdd or remove tags from a contact
add_member_noteAttach a CRM-style internal note to a contact
update_member_noteUpdate the text of an existing member note
delete_member_noteDelete a member note
batch_subscribeBatch add/update multiple members in an audience
update_audienceUpdate audience settings (name, defaults, permission reminder)
create_audienceCreate a new audience with contact info and campaign defaults
delete_audiencePermanently delete an audience and all its data
list_segmentsList segments and tags for an audience
get_segmentGet segment details including conditions
list_segment_membersList members in a segment
create_segmentCreate a new segment or tag (static or dynamic with conditions)
update_segmentUpdate a segment's name or conditions
delete_segmentDelete a segment or tag
add_members_to_segmentAdd contacts to a segment/tag
remove_members_from_segmentRemove contacts from a segment/tag
list_merge_fieldsList custom fields for an audience
create_merge_fieldCreate a new custom field (text, number, dropdown, etc.)
update_merge_fieldUpdate a custom field
delete_merge_fieldDelete a custom field
list_interest_categoriesList interest categories for an audience
create_interest_categoryCreate a new interest category
list_interestsList interests within a category
create_interestCreate a new interest option
delete_interest_categoryDelete an interest category
delete_interestDelete an interest option
list_webhooksList webhooks for an audience
create_webhookCreate a new webhook
delete_webhookDelete a webhook
list_automationsList Classic Automation workflows (Customer Journeys are not exposed by Mailchimp's API)
get_automation_emailsList emails in a Classic workflow
get_automation_email_queueView the send queue for an automation email
pause_automationPause all emails in a Classic workflow
start_automationStart/resume all emails in a Classic workflow
trigger_customer_journeyEnroll a contact into a Customer Journey step (the only journey write Mailchimp exposes)
search_automation_campaignsList campaigns emitted by either Classic Automations or Customer Journeys
get_member_journey_eventsFilter a member's activity feed to automation/journey-related events
get_automation_summaryCombined overview: Classic workflows by status + recent automation send volume
list_templatesList available email templates
get_templateGet template metadata (name, type, dates, thumbnail)
get_template_default_contentGet template HTML content
create_templateCreate a new email template
update_templateUpdate template name or HTML
delete_templateDelete a user-created template
list_landing_pagesList all landing pages
get_landing_pageGet details of a landing page
create_landing_pageCreate a new landing page from a template
update_landing_pageUpdate settings of an existing landing page
delete_landing_pagePermanently delete a landing page
publish_landing_pagePublish a landing page to its public URL
unpublish_landing_pageTake a published landing page offline
list_filesList images and files stored in the File Manager
get_fileGet a single file's metadata and hosted URL
upload_fileUpload a new image or file (base64-encoded)
delete_filePermanently delete a file
list_file_foldersList File Manager folders
list_surveysList an audience's surveys with status and public URL
get_surveyGet a single survey's full details
publish_surveyPublish a survey to its public URL
unpublish_surveyTake a published survey offline
list_signup_formsGet the signup forms configured for an audience
customize_signup_formCustomize a signup form's header, contents, and styles
list_ecommerce_storesList connected e-commerce stores
list_store_ordersList orders from a store
list_store_productsList products from a store
list_store_customersList customers from a store
list_store_cartsList carts (including abandoned) for a store
get_store_cartGet a single cart with full line items
create_store_cartPush a cart (e.g. an abandoned cart from an external system)
update_store_cartUpdate a cart's totals, currency, checkout URL, or line items
delete_store_cartPermanently delete a cart
list_promo_rulesList discount rules for a store
get_promo_ruleGet a single promo rule's configuration
create_promo_ruleCreate a discount rule (fixed amount, percentage, free shipping)
update_promo_ruleUpdate a rule's amount, target, dates, or enabled state
delete_promo_rulePermanently delete a rule and all its codes
list_promo_codesList redeemable codes attached to a rule
get_promo_codeGet a single promo code with usage stats
create_promo_codeCreate a redeemable code (e.g. 'SUMMER20') under a rule
update_promo_codeUpdate a code's string, redemption URL, or enabled state
delete_promo_codePermanently delete a promo code
create_batchRun multiple API operations in bulk
get_batch_statusCheck status of a batch operation
list_batchesList recent batch operations
list_batch_webhooksList batch-completion webhooks
get_batch_webhookGet a single batch webhook
create_batch_webhookCreate a batch-completion webhook
update_batch_webhookUpdate a batch webhook's URL
delete_batch_webhookDelete a batch webhook
list_verified_domainsList sending domains and their verification state
get_verified_domainGet a single sending domain's record
create_verified_domainStart verification for a sending domain
verify_verified_domainComplete verification with the emailed code
delete_verified_domainRemove a verified sending domain
list_connected_sitesList connected sites for tracking and pop-ups
get_connected_siteGet a single connected site with its script
create_connected_siteConnect a website and generate its script
delete_connected_siteRemove a connected site
verify_connected_site_scriptVerify the tracking script is installed
list_authorized_appsList OAuth-authorized applications
get_authorized_appGet a single authorized application
get_chimp_chatterRead the account activity feed
list_account_exportsList account data export jobs
get_account_exportGet an export job's status and download URL
create_account_exportStart an account data export
create_campaign_folderCreate a campaign folder
get_campaign_folderGet a single campaign folder
update_campaign_folderRename a campaign folder
delete_campaign_folderDelete a campaign folder
list_template_foldersList template folders
get_template_folderGet a single template folder
create_template_folderCreate a template folder
update_template_folderRename a template folder
delete_template_folderDelete a template folder
get_campaign_send_checklistPre-send readiness checklist
list_campaign_feedbackList team collaboration comments
get_campaign_feedbackGet a single comment
create_campaign_feedbackAdd a collaboration comment
update_campaign_feedbackEdit a comment
delete_campaign_feedbackDelete a comment
pause_rss_campaignPause an RSS-driven campaign
resume_rss_campaignResume an RSS-driven campaign
get_audience_activityRecent daily activity for an audience
get_audience_top_locationsTop countries of an audience
get_audience_clientsTop email clients used by an audience
list_audience_abuse_reportsSpam complaints for an audience
get_audience_abuse_reportA single audience abuse report
upsert_memberAdd-or-update a member idempotently (PUT)
delete_member_permanentGDPR permanent erasure of a member
get_member_goalsA member's recent tracked goal events
add_member_eventRecord a custom event on a member
get_automation_emailGet one email in a classic automation
pause_automation_emailPause a single automation email
start_automation_emailStart a single automation email
add_automation_queue_subscriberEnqueue a subscriber for an automation email
get_automation_queue_subscriberGet a subscriber's queue status
list_automation_removed_subscribersList subscribers removed from a workflow
remove_automation_subscriberRemove a subscriber from a workflow
get_automation_removed_subscriberGet a single removed subscriber
get_campaign_sent_toPer-recipient delivery status for a campaign
get_campaign_abuse_reportsSpam complaints for a campaign
get_campaign_abuse_reportA single campaign abuse report
list_landing_page_reportsReports across all landing pages
get_landing_page_reportReport for a single landing page
list_survey_reportsReports across all surveys
get_survey_reportReport for a single survey
get_survey_responsesList a survey's responses
get_survey_responseGet a single survey response
get_survey_questions_reportPer-question survey report
get_survey_question_answersAnswers for a single survey question
list_account_ordersList orders across every store

How to install the mailchimp-mcp-server MCP Server

{
  "mcpServers": {
    "mailchimp": {
      "command": "uvx",
      "args": [
        "mailchimp-mcp"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "YOUR_MAILCHIMP_API_KEY",
        "MAILCHIMP_READ_ONLY": "true"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MAILCHIMP_API_KEYDeclared in the maintainer’s client configuration.Yes
MAILCHIMP_READ_ONLYDeclared in the maintainer’s client configuration.Optional