---
id: mailchimp3
version: "3.0.21"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# mailchimp3 — A python client for v3 of MailChimp API

License: permissive · Maintenance: dormant · Downloads: 289.3K/mo

## What it is and what it does

mailchimp3 is a straightforward Python wrapper around MailChimp's REST API v3, built on top of the requests library. It provides object-oriented access to MailChimp's endpoints—lists, members, campaigns, automations, stores, reports, and more—without requiring you to construct HTTP requests manually. You initialize it with an API key (and optionally a username for basic auth or an OAuth2 token), then call methods like client.lists.all(), client.lists.members.create(), or client.campaigns.all() to interact with your MailChimp account.

The package handles pagination, field selection, and request headers for you. It supports both HTTP Basic Authentication and OAuth2, allows you to set request timeouts and custom User-Agent headers, and can be disabled at runtime to return None for all calls. The API structure mirrors MailChimp's official documentation, so if you know the endpoint you want, the method names are predictable. It has been stable since its first release in 2015 and covers all documented endpoints as of March 2017, though maintenance is now dormant.

Use it for:

- Sync subscriber lists and manage member data (add, update, delete) programmatically without manual MailChimp UI interaction.
- Automate campaign creation and sending workflows triggered by application events.
- Fetch campaign performance reports, click analytics, and email activity data for analysis or dashboards.
- Build integrations that read and write e-commerce data (stores, products, orders, carts) to MailChimp.
- Query and manage automation workflows, segments, and interest categories across multiple lists.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client for MailChimp API v3 that wraps HTTP requests to manage lists, campaigns, automations, and other MailChimp resources through a structured object interface.

Yes, if you need a stable, low-friction MailChimp v3 API client and can accept dormant maintenance. The package is production-stable, has no known vulnerabilities, and a single lightweight dependency. It is not suitable if you require active upstream support, ongoing API compatibility updates, or expect MailChimp to introduce breaking changes that demand prompt library updates.

## Install

pip install mailchimp3
uv add mailchimp3
poetry add mailchimp3

## Installing mailchimp3

Before you install: Low install friction with a single runtime dependency (requests). Maintenance is dormant—last release was 2023-06-13, over 1158 days ago, though the repository remains active with 461 stars and no recent commits. Suitable for stable, established integrations but not for projects requiring active upstream support.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions, provided you include the license notice.

Quickstart:

pip install mailchimp3

from mailchimp3 import MailChimp

client = MailChimp(mc_api='YOUR_API_KEY')
all_lists = client.lists.all(get_all=True)

Verify before relying:

- Whether dormant maintenance status affects compatibility with current MailChimp API changes or OAuth2 flow reliability.
- Performance characteristics when fetching large record sets with pagination (count=500 recommended but not benchmarked in fact sheet).

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 289.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mailchimp api client python, mailchimp v3 wrapper, email list management api, mailchimp automation python, campaign management client, mailchimp rest api python, subscriber management library, email-marketing, rest-api-client, dormant-maintenance

[View on SkillFed](https://skillfed.io/packages/mailchimp3) · [View on PyPI](https://pypi.org/project/mailchimp3/)