matimo-mailchimp 0.1.0

Matimo provider — Mailchimp tools (campaigns, lists, members)

matimo-mailchimp

Mailchimp tools for Matimo — manage campaigns, lists, and subscribers.

---

Installation

pip install matimo matimo-mailchimp

---

Available Tools (7 Total)

Tool	Description
mailchimp-get-lists	List all audiences (lists) in your account
mailchimp-get-list-members	Get subscribers in an audience
mailchimp-add-list-member	Subscribe an email address to an audience
mailchimp-update-list-member	Update subscriber tags, status, or merge fields
mailchimp-remove-list-member	Unsubscribe or archive a list member
mailchimp-create-campaign	Create a new email campaign
mailchimp-send-campaign	Send a campaign to its audience

---

Quick Start

import asyncio
import os
from matimo import Matimo
from matimo_mailchimp import get_tools_path

async def main():
    matimo = await Matimo.init(get_tools_path())

    # List all audiences
    lists = await matimo.execute('mailchimp-get-lists', {})
    print(lists)

    # Add a subscriber
    await matimo.execute('mailchimp-add-list-member', {
        'list_id': 'abc123def',
        'email_address': '[e-mail]',
        'status': 'subscribed',
        'merge_fields': {'FNAME': 'Jane', 'LNAME': 'Doe'},
    })

    # Create and send a campaign
    campaign = await matimo.execute('mailchimp-create-campaign', {
        'list_id': 'abc123def',
        'subject_line': 'April Newsletter',
        'from_name': 'My Company',
        'reply_to': '[e-mail]',
    })
    await matimo.execute('mailchimp-send-campaign', {
        'campaign_id': campaign['id'],
    })

asyncio.run(main())

---

Authentication

export MAILCHIMP_API_KEY="your-api-key-us1"     # includes datacenter suffix
export MAILCHIMP_SERVER_PREFIX="us1"             # datacenter prefix from your API key

Getting Mailchimp API Credentials

1. Log in to Mailchimp → Profile → Extras → API keys
2. Click Create A Key
3. Copy the API key — the suffix (us1, us6, etc.) is your server prefix

---

Documentation

• Mailchimp Marketing API
• Python Examples

---

Links

• PyPI: https://pypi.org/project/matimo-mailchimp/
• GitHub: https://github.com/tallclub/matimo
• Mailchimp Developer Docs: https://mailchimp.com/developer/