mailchimp-mcp-server

An MCP (Model Context Protocol) server that connects Claude Code (or any MCP client) to the Mailchimp Marketing API. Check campaign analytics, manage audiences, browse reports — all through natural language.

What it does

30 tools for reading and managing your Mailchimp account:

Account

• mailchimp_ping — Health check to verify API connection
• mailchimp_get_account — Account info (name, plan, contact totals)

Campaigns

• mailchimp_list_campaigns — List campaigns with filters (type, status, sort)
• mailchimp_get_campaign — Detailed info about a specific campaign
• mailchimp_get_campaign_content — HTML and plain-text content of a campaign
• mailchimp_create_campaign — Create a new draft campaign
• mailchimp_set_campaign_content — Set HTML/text content or assign a template
• mailchimp_send_campaign — Send a campaign immediately
• mailchimp_schedule_campaign — Schedule a campaign for a future time
• mailchimp_unschedule_campaign — Unschedule a scheduled campaign
• mailchimp_delete_campaign — Permanently delete a campaign

Reports / Analytics

• mailchimp_list_reports — Campaign reports with open rates, click rates, send stats
• mailchimp_get_campaign_report — Detailed report (opens, clicks, bounces, unsubscribes)
• mailchimp_get_click_details — Which links were clicked and how many times
• mailchimp_get_open_details — Who opened and when
• mailchimp_get_email_activity — Per-subscriber activity (opens, clicks, bounces)
• mailchimp_get_unsubscribes — Unsubscribe details for a campaign

Audiences / Lists

• mailchimp_list_audiences — List all audiences with subscriber counts
• mailchimp_get_audience — Detailed audience info and stats
• mailchimp_list_members — List subscribers with optional status filter
• mailchimp_get_member — Get a specific subscriber's info
• mailchimp_search_members — Search members by email or name across audiences
• mailchimp_add_member — Add a new subscriber
• mailchimp_update_member — Update a subscriber's info or status
• mailchimp_get_audience_growth — Subscriber growth history over time
• mailchimp_list_segments — List saved segments for an audience
• mailchimp_get_segment — Get segment details and member count
• mailchimp_list_tags — List all tags for an audience

Templates

• mailchimp_list_templates — List email templates
• mailchimp_get_template — Get template details

Automations (classic automations only — automation flows are not yet available via the Mailchimp API)

• mailchimp_list_automations — List all automations
• mailchimp_get_automation — Get automation workflow details
• mailchimp_get_automation_emails — Get emails/steps in an automation
• mailchimp_start_automation — Start a paused automation
• mailchimp_pause_automation — Pause an active automation

Prerequisites

You need a Mailchimp account with an API key.

Step 1: Get your API key

1. Log into Mailchimp and go to Account & billing
2. Navigate to Extras > API keys
3. Click Create A Key and give it a name (e.g., "Claude Code MCP")
4. Copy the key immediately — it looks like abc123def456-us12

Step 2: Note your data center

Your data center is the suffix after the dash in your API key. For example, if your key ends with -us12, your data center is us12.

You can also find it in the URL when logged into Mailchimp: https://us12.admin.mailchimp.com/ — the us12 part is your data center.

Installation

Option A: Clone and build locally

git clone https://github.com/noahrasheta/mailchimp-mcp-server.git
cd mailchimp-mcp-server
npm install
npm run build

Then configure your MCP client:

{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/path/to/mailchimp-mcp-server/build/index.js"],
      "env": {
        "MAILCHIMP_API_KEY": "your_api_key_here",
        "MAILCHIMP_SERVER_PREFIX": "us12"
      }
    }
  }
}

Option B: npx (after publishing to npm)

{
  "mcpServers": {
    "mailchimp": {
      "command": "npx",
      "args": ["-y", "mailchimp-mcp-server"],
      "env": {
        "MAILCHIMP_API_KEY": "your_api_key_here",
        "MAILCHIMP_SERVER_PREFIX": "us12"
      }
    }
  }
}

Claude Code Setup

Add the MCP server config to one of these locations:

• Global (all projects): ~/.claude.json under the mcpServers key
• Project-specific: .mcp.json in your project root

After adding the config, restart Claude Code. You can verify it's connected by running /mcp to check server status, then try:

• "Ping my Mailchimp account"
• "Show me my recent campaigns"
• "Get the report for my last email campaign"
• "How many subscribers do I have?"

Environment Variables

Variable	Required	Description
MAILCHIMP_API_KEY	Yes	Your Mailchimp API key (e.g., abc123-us12)
MAILCHIMP_SERVER_PREFIX	Yes	Your data center prefix (e.g., us12)

Testing

You can test interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js

Make sure to set the environment variables first:

export MAILCHIMP_API_KEY="your_api_key_here"
export MAILCHIMP_SERVER_PREFIX="us12"
npx @modelcontextprotocol/inspector node build/index.js

Tech Stack

• TypeScript with the MCP TypeScript SDK
• @mailchimp/mailchimp_marketing — Official Mailchimp Marketing API client
• Zod for input validation
• stdio transport for local MCP communication

License

MIT