mailchimp-marketing-api-toolkit — Claude Code skill: what it does
mailchimp-marketing-api-toolkit gives the agent ready Python calls for the Mailchimp Marketing API: audiences, campaigns, A/B tests and welcome automations.
no license 154 installs ★ 12 updated 2026-10-09
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a claude-codeWhat mailchimp-marketing-api-toolkit 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.
What it helps with
- 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 for the agent
- List my Mailchimp audiences and print each ID
- Create a campaign for list
abc123with this HTML and send a test to[email protected] - Upload
contacts.csvin batch and update existing members
How to install mailchimp-marketing-api-toolkit
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a claude-code2Manually: put the files in place
~/.claude/skills/mailchimp-marketing-api-toolkit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mailchimp-marketing-api-toolkit/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a codex2Manually: put the files in place
.agents/skills/mailchimp-marketing-api-toolkit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a cursor2Manually: put the files in place
.cursor/skills/mailchimp-marketing-api-toolkit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/marketing-skills skills/mailchimp-marketing-api-toolkit2Manually: put the files in place
.github/skills/mailchimp-marketing-api-toolkit/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/marketing-skills --path skills/mailchimp-marketing-api-toolkitManually: put the files in place
.devin/skills/mailchimp-marketing-api-toolkit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mailchimp-marketing-api-toolkit
How do I install mailchimp-marketing-api-toolkit in Claude Code?
Run npx skills add reason-machines/marketing-skills --skill mailchimp-marketing-api-toolkit -a claude-code. The skill file lands at ~/.claude/skills/mailchimp-marketing-api-toolkit/SKILL.md.
What does mailchimp-marketing-api-toolkit do?
It gives the agent Python recipes for the Mailchimp Marketing API: audiences, subscribers, campaigns, A/B tests and automations.
What do I need before using it?
A Mailchimp API key in MAILCHIMP_API_KEY and its server prefix in MAILCHIMP_SERVER_PREFIX, taken from the end of that key. Python with mailchimp_marketing installed as well.