Mailchimp Integration

Pro v1.0.0

Manage Mailchimp audiences, campaigns, and email marketing automation through the Marketing API

Requires Claude Code CLI

This skill integrates with Mailchimp through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Test Connection

Verify API credentials and connection to Mailchimp

Returns

object API health status

Try saying...

  • "Test my Mailchimp connection"
  • "Ping the Mailchimp API"
  • "Verify my Mailchimp credentials work"

List Audiences

Get all audiences (mailing lists) in your Mailchimp account

Returns

object Array of audience objects with stats and metadata

Try saying...

  • "Show me all my Mailchimp audiences"
  • "List my email lists"
  • "What audiences do I have in Mailchimp?"

Get Audience Details

Retrieve detailed information about a specific audience

Parameters

Name Type Required Description
audience_id string Required The unique ID for the audience

Returns

object Detailed audience information including stats, settings, and metadata

Try saying...

  • "Get details for audience abc123"
  • "Show me info about my newsletter list"
  • "What are the stats for audience xyz789?"

List Campaigns

Get email campaigns from your account

Parameters

Name Type Required Description
count integer Optional Number of campaigns to return

Returns

object Array of campaign objects with performance stats

Try saying...

  • "Show me my recent campaigns"
  • "List my Mailchimp campaigns"
  • "What are my last 20 email campaigns?"

Get Campaign Details

Retrieve detailed information and stats for a specific campaign

Parameters

Name Type Required Description
campaign_id string Required The unique ID for the campaign

Returns

object Detailed campaign information including report summary and settings

Try saying...

  • "Get campaign abc123 details"
  • "Show me the stats for my latest campaign"
  • "What's the open rate for campaign xyz789?"

List Audience Members

Get subscribers from a specific audience

Parameters

Name Type Required Description
audience_id string Required The unique ID for the audience
count integer Optional Number of members to return

Returns

object Array of member objects with email addresses and subscription info

Try saying...

  • "Show me members of audience abc123"
  • "List subscribers in my newsletter"
  • "Who's subscribed to audience xyz789?"

Add Member to Audience

Subscribe a new member to an audience

Parameters

Name Type Required Description
audience_id string Required The unique ID for the audience
email string Required Email address to subscribe
status string Required Subscription status

Returns

object Created member object with subscription details

Try saying...

  • "Add user@example.com to audience abc123"
  • "Subscribe someone to my newsletter"
  • "Add a new subscriber to my mailing list"

Getting Started

API Key Easy Setup
  1. 1 Log in to your Mailchimp account
  2. 2 Go to Profile > Extras > API Keys
  3. 3 Click 'Create A Key' and give it a descriptive name
  4. 4 Click 'Generate Key' and copy it immediately (shown only once)
  5. 5 Find your data center from the API key suffix (e.g., 'abc123-us6' means dc is 'us6')
  6. 6 Add to shell config: echo 'export MAILCHIMP_API_KEY="YOUR_KEY"' >> ~/.zshrc
  7. 7 Add to shell config: echo 'export MAILCHIMP_DATA_CENTER="YOUR_DC"' >> ~/.zshrc
  8. 8 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py ping

Success: Returns JSON with 'health_status': 'Everything's Chimpy!'

View full setup guide

Security & Access

Access Scope

Full access to your Mailchimp account including audiences, campaigns, automations, and e-commerce data

  • API key provides complete access to your Mailchimp account
  • Keep your API key secure and never commit it to version control
  • Create separate API keys for each integration for easier revocation
  • API keys do not expire but can be revoked from account settings
  • User role permissions determine which API endpoints are accessible

Limitations

  • Rate limits vary by Mailchimp plan tier
  • Large data operations should use pagination to avoid timeouts
  • Client-side CORS requests are not supported for security

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
PYTHON_SDK
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
mailchimp-marketing>=3.0.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements