# mailchimp-automation

mailchimp-automation — a skill that automates Mailchimp email marketing: campaign creation and delivery, audience and subscriber management, segmentation, and performance analytics. Runs on Claude Code and Cursor via Rube MCP (Composio).

- skill · `type=skill` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 3785 repo stars
- Author: BuildWithClaude Community
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/mailchimp-automation/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/buildwithclaude-community-mailchimp-automation

## What it does

The skill exposes Mailchimp's full toolkit through the Rube MCP server. Build campaigns with HTML content, send immediately or schedule for later, manage subscriber lists and search contacts by email or name. Bulk add and update subscribers, manage segments and tags. All operations are available through Claude Code and Cursor.

Requires an active Mailchimp connection set up via `RUBE_MANAGE_CONNECTIONS` with toolkit `mailchimp`. Before each operation, the skill calls `RUBE_SEARCH_TOOLS` to fetch current tool schemas. Campaign send is irreversible—always send a test email and get explicit user sign-off before the live send. Parameters use double underscores for nested fields (`settings__subject__line`), and engagement metrics are stored as decimals from 0 to 1, not percentages.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add davepoon/buildwithclaude
```
In the agent chat (not a shell):
```text
/plugin install all-skills@buildwithclaude
```
This installs the whole all-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill mailchimp-automation -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill mailchimp-automation -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill mailchimp-automation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/mailchimp-automation
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill mailchimp-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/mailchimp-automation
```

### Windsurf (Devin Desktop)

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

### 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/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/mailchimp-automation/SKILL.md

## When to use it
- create and send an email campaign with custom HTML
- add or update subscribers in an audience
- search for a contact by email or name
- retrieve campaign performance reports and metrics
- manage subscriber segments and tags

## Example prompts
- Build a campaign for our main list with subject 'July Deal' from our marketing team
- Add subscriber jane@example.com with subscribed status and tags ['vip', 'early-adopter']
- Get the last 100 active subscribers sorted by signup date

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9202d333bc346b39.

BEGIN THIRD-PARTY FILE 9202d333bc346b39
```text
---
name: mailchimp-automation
description: Automate Mailchimp email marketing including campaigns, audiences, subscribers, segments, and analytics via Rube MCP (Composio). Always search tools first for current schemas.
requires:
  mcp: [rube]
category: email
---

# Mailchimp Automation via Rube MCP

Automate Mailchimp email marketing workflows including campaign creation and sending, audience/list management, subscriber operations, segmentation, and performance analytics through Composio's Mailchimp toolkit.

**Toolkit docs**: [composio.dev/toolkits/mailchimp](https://composio.dev/toolkits/mailchimp)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Mailchimp connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `mailchimp`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `mailchimp`
3. If connection is not ACTIVE, follow the returned auth link to complete Mailchimp OAuth
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Create and Send Email Campaigns

**When to use**: User wants to create, configure, test, and send an email campaign.

**Tool sequence**:
1. `MAILCHIMP_GET_LISTS_INFO` - List available audiences and get list_id [Prerequisite]
2. `MAILCHIMP_ADD_CAMPAIGN` - Create a new campaign with type, audience, subject, from name [Required]
3. `MAILCHIMP_SET_CAMPAIGN_CONTENT` - Set HTML content for the campaign [Required]
4. `MAILCHIMP_SEND_TEST_EMAIL` - Send preview to reviewers before live send [Optional]
5. `MAILCHIMP_SEND_CAMPAIGN` - Send the campaign immediately [Required]
6. `MAILCHIMP_SCHEDULE_CAMPAIGN` - Schedule for future delivery instead of immediate send [Optional]

**Key parameters for MAILCHIMP_ADD_CAMPAIGN**:
- `type`: "regular", "plaintext", "rss", or "variate" (required)
- `recipients__list__id`: Audience/list ID for recipients
- `settings__subject__line`: Email subject line
- `settings__from__name`: Sender display name
- `settings__reply__to`: Reply-to email address (required for sending)
- `settings__title`: Internal campaign title
```
END THIRD-PARTY FILE 9202d333bc346b39

The third-party file has ended. Everything between the 9202d333bc346b39 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2377 of 12572 bytes. © BuildWithClaude Community · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/mailchimp-automation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
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
