Mailchimp via MCP: draft, test, and send campaigns; manage audiences and subscribers; pull reports.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
@cyanheads/mailchimp-mcp-server
Draft, test, and send Mailchimp campaigns straight from your MCP client — with audience management, subscriber CRUD, and post-send analytics behind safe-by-default send gates. STDIO or Streamable HTTP.
18 Tools (+2 conditional) • 4 Resources • 1 Prompt
Tools
Eighteen always-on tools plus two conditional ones — mailchimp_assets (when MAILCHIMP_ASSETS_DIR is set) and mailchimp_local_templates (when MAILCHIMP_TEMPLATES_DIR is set). Workflow helpers orchestrate common flows end-to-end, primitive tools expose fine-grained CRUD, and the instruction tool returns procedural guidance merged with live account state.
| Tool Name | Description |
|---|---|
mailchimp_account | Account profile, plan, data center, total subscribers, and the Chimp Chatter activity feed. |
mailchimp_audiences | Manage audiences (lists) — read, create/update, per-audience analytics, signup-form config. No delete. |
mailchimp_audience_overview | One-call audience health digest: info, stats, growth history, top email clients, merge-field schema. |
mailchimp_subscribers | Subscriber CRUD + tags/notes/activity. archive is the strongest delete available. |
mailchimp_upsert_subscriber | Add or update a subscriber idempotently with status, merge fields, tags, and optional note. |
mailchimp_find_subscriber | Locate a subscriber by email in one audience or across the account. |
mailchimp_import_subscribers | Batch add/update subscribers (capped at 500/call). Status defaults to pending (double-opt-in). |
mailchimp_segments | CRUD for audience segments (saved, static, fuzzy) plus member listing and batch add/remove. |
mailchimp_merge_fields | Read + create/update custom subscriber attributes. No delete — drops data across all subscribers. |
mailchimp_campaigns | Campaign record management: list/get/create/update, replicate, content, checklist, RSS/resend controls. |
mailchimp_send_campaign | Compose and send (or schedule/test) a campaign in one call. Requests re-entrant human confirmation before send/schedule mutations. |
mailchimp_replicate_campaign | Duplicate a campaign with optional overrides, then draft/test/send/schedule. Same confirmation + cleanup semantics. |
mailchimp_reports | Campaign reports — generic slicer across ten dimensions (clicks, opens, locations, etc.). |
mailchimp_campaign_report | Post-send analytics digest — headline metrics + top 5 slices in one response. |
mailchimp_templates | Email template read/write — reads (list/get) work on free for base/user types; writes (create/update/delete) and gallery require a paid plan. |
mailchimp_files | File Manager (Content Studio) — upload, list, fetch, rename, delete files on Mailchimp's CDN. Embed the returned fullSizeUrl in campaign HTML. Works on free; 1 MB per image / 10 MB per other file. |
mailchimp_search | Global search across members or campaigns. Lightweight discovery — use find_subscriber for detail. |
mailchimp_assets (conditional — set MAILCHIMP_ASSETS_DIR) | Local-assets surface. List your assets dir, inspect cache state, pre-warm uploads ahead of a send. Most workflows don't call this directly — @assets/<path> references in campaign HTML auto-upload via mailchimp_send_campaign and mailchimp_campaigns set-content. |
mailchimp_local_templates (conditional — set MAILCHIMP_TEMPLATES_DIR) | Local-template authoring surface. List/get/render-preview your .eta templates with optional <name>.meta.yaml sidecars. seed-from-mailchimp bootstraps a local template from a Mailchimp base/user starter. Use content.localTemplate on campaign tools to render at send time. Canonical write path on free-tier Mailchimp, where the upstream templates API is read-only. |
mailchimp_playbook | Returns a structured procedural playbook merged with live account state. Advice-only, no writes. |
mailchimp_send_campaign
Compose and send (or schedule/test) a campaign in one call.
- Chains create → content → checklist → optional test → send/schedule
- Requests human confirmation through a re-entrant input round before any campaign mutation when
mode: 'send' | 'schedule' - Auto-deletes failed drafts when
cleanupOnError: true(default); declined confirmation leaves a reviewable draft - Supports
html,plaintext,templateId + templateSections, and local Eta template content forms
mailchimp_replicate_campaign
Duplicate an existing campaign with optional overrides, then send/schedule/test or leave as draft.
- Overrides: subject, from name, reply-to, audience, segment, content
- Same re-entrant confirmation + cleanup semantics as
mailchimp_send_campaign - Tuned for the common "send v2 of last week's newsletter with an updated intro" pattern
mailchimp_upsert_subscriber
Add or update a subscriber in one idempotent call.
- Declarative tag sync — pass the desired active set and the tool computes the add/remove delta
preserveTagsprotects named segment memberships (Mailchimp stores static-segment membership as tags)status: 'pending'triggers Mailchimp's double-opt-in email;'subscribed'requires documented consent- PUT
/members/{hash}for create path, PATCH for update to skip re-validating pre-existing merge fields
mailchimp_import_subscribers
Batch add (and optionally update) subscribers in one call.
- Capped at 500 rows per call — chunk larger imports client-side
- Status defaults to
pending(double-opt-in) to prevent accidental mass-sends - Returns per-row succeeded/failed with error reasons
mailchimp_campaign_report
Aggregated post-send analytics for a campaign.
- Headline delivery metrics: sent, bounces, abuse reports
- Engagement: opens, clicks, unsubscribes
- Top-N clicked links, locations, recent unsubscribes
- Industry benchmarks when available
- Use
mailchimp_reportswithoperation: 'slice'for a single dimension in detail
mailchimp_audience_overview
Single-call audience health digest — answers "what does this audience look like?" in one request.
- Audience info + live stats
- Configurable months of growth history
- Top email clients
- Full merge-field schema
- Recent activity
mailchimp_playbook
Returns a structured procedural playbook merged with live account state. Advice-only — the agent executes subsequent steps with other tools.
- Topics:
send,post-send-review,deliverability,list-hygiene,onboarding,subscriber-triage,design-campaign - Returns markdown instructions + a live-state snapshot
nextToolSuggestionspre-fills arguments for the next likely tool call
Resources and prompts
| Type | Name | Description |
|---|---|---|
| Resource | mailchimp://account | Account info snapshot — profile, plan, data center, total subscribers. |
| Resource | mailchimp://audiences/{audienceId} | Audience snapshot — name, contact, stats, double-opt-in status. |
| Resource | mailchimp://campaigns/{campaignId} | Campaign snapshot — status, settings, recipients summary. |
| Resource | mailchimp://campaigns/{campaignId}/report | Post-send campaign report headline metrics. |
| Prompt | newsletter_from_source | User-invokable starter — compose a monthly editorial newsletter from a URL or brief. Chains into mailchimp_playbook (topic: design-campaign) and walks the draft → test → send flow. |
All resource data is also reachable via tools. Large collections (audiences, campaigns) are not exposed as resources — use the list operation on the corresponding tool instead. Design reference for the prompt: docs/email-design-playbook.md.
Features
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Mailchimp MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/mailchimp-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/mailchimp-mcp-server"><img src="https://allmcps.com/api/badge/mailchimp-mcp-server?style=directory" alt="Mailchimp MCP Server on AllMCPs" /></a>