# mailchimp-mcp

MCP server for the [Mailchimp](https://mailchimp.com/) Marketing API. Create campaigns, manage audiences, send emails, and handle subscribers.

## Tools

| Tool | Description |
|------|-------------|
| `list_audiences` | List all audiences/lists |
| `list_templates` | List email templates |
| `list_campaigns` | List recent campaigns |
| `get_campaign` | Get campaign details |
| `create_campaign` | Create a new email campaign |
| `set_campaign_content` | Set HTML/template content for a campaign |
| `get_campaign_content` | Get current campaign content |
| `send_test_email` | Send a test email before full send |
| `send_campaign` | Send a campaign to its audience |
| `schedule_campaign` | Schedule a campaign for future send |
| `list_members` | List subscribers in an audience |
| `add_or_update_member` | Add or update a subscriber (upsert) |
| `batch_add_members` | Bulk add up to 500 subscribers |

## Setup

1. Install dependencies:
   ```bash
   npm install
   ```

2. Copy `.env.example` to `.env` and fill in your API key:
   ```bash
   cp .env.example .env
   ```

   Required environment variables:
   - `MAILCHIMP_API_KEY` - Your Mailchimp API key (format: `key-dc`, e.g. `abc123-us21`)

## Usage with Claude Code

Add to your Claude Code MCP config (`~/.claude.json`):

```json
{
  "mcpServers": {
    "mailchimp": {
      "command": "node",
      "args": ["/path/to/mailchimp-mcp/server.js"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-us21"
      }
    }
  }
}
```

## License

MIT