# mailchimp-marketing-api-toolkit

mailchimp-marketing-api-toolkit gives the agent ready Python calls for the Mailchimp Marketing API: audiences, campaigns, A/B tests and welcome automations.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 154 installs · ★ 12 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/marketing-skills/tree/HEAD/skills/mailchimp-marketing-api-toolkit/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — warning: a PowerShell command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/skills/mailchimp-marketing-api-toolkit

## What it does

The skill hands the agent working calls against the Mailchimp Marketing API from Python. It can list every audience with its ID, spin up a new list with company contact details and campaign defaults, and add a subscriber with tags and merge fields. Bulk upload goes through one batch call with `update_existing`, which keeps repeat addresses from turning into duplicates.

Campaign work follows the same pattern: create a regular campaign, attach HTML, fire a test to one or two inboxes, then send right away or set `schedule_time` for later. A variate campaign covers A/B splits, with the winner picked by opens, clicks or revenue. Automations are built as a welcome series with an email step and a delay.

Calls run through the `mailchimp_marketing` library, so Python and that package need to be in the project. Two environment variables come first: `MAILCHIMP_API_KEY` and `MAILCHIMP_SERVER_PREFIX`. The prefix is the tail of the key after its last hyphen, so `abc123-us1` means `us1`. Set a prefix that doesn't match the key and every request fails.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mailchimp-marketing-api-toolkit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mailchimp-marketing-api-toolkit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mailchimp-marketing-api-toolkit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mailchimp-marketing-api-toolkit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/marketing-skills skills/mailchimp-marketing-api-toolkit
```

2. **Manually: put the files in place**
- File: `.github/skills/mailchimp-marketing-api-toolkit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/marketing-skills --path skills/mailchimp-marketing-api-toolkit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mailchimp-marketing-api-toolkit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/marketing-skills/tree/HEAD/skills/mailchimp-marketing-api-toolkit/SKILL.md

## When to use it
- pull every audience list with its ID
- create a new audience with sender defaults
- batch-upload subscribers and update existing ones
- attach HTML to a campaign and send a test
- build a welcome series with a delay

## Example prompts
- List my Mailchimp audiences and print each ID
- Create a campaign for list `abc123` with this HTML and send a test to `qa@example.com`
- Upload `contacts.csv` in batch and update existing members

## Similar
- [Mailchimp Automation](https://affpapa.org/en/nevibecode/skills/mailchimp-automation.md) — skill · 4800 installs
- [cli-anything-mailchimp](https://affpapa.org/en/nevibecode/skills/cli-anything-mailchimp.md) — skill · 407 installs
- [ecommerce-email-marketing-builder](https://affpapa.org/en/nevibecode/skills/ecommerce-email-marketing-builder.md) — skill · 1300 installs
- [mailchimp](https://affpapa.org/en/nevibecode/skills/mailchimp.md) — skill · 247 installs
- [mailchimp-automation](https://affpapa.org/en/nevibecode/skills/buildwithclaude-community-mailchimp-automation.md) — skill · ★ 3785 repo stars
- [subject-line-lab](https://affpapa.org/en/nevibecode/skills/cogny-ai-subject-line-lab.md) — skill · ★ 116 repo stars

From the same set: [reason-machines/marketing-skills](https://affpapa.org/en/nevibecode/by/reason-machines/marketing-skills.md) — 79 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
