What You'll Set Up

By the end of this guide, your AI agent will be able to manage your Mailchimp account — working with audiences, campaigns, templates, and more. The entire setup takes about five minutes.

Mailchimp

49 tools · Email marketing automation for AI agents

Before You Begin

Make sure you have:

A Mailchimp account — Create one for free if you don't have one
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Steps

Get your Mailchimp API key

Log into your Mailchimp account. Go to Account > Extras > API keys. Click Create A Key to generate a new API key.

Your Mailchimp API key will look like xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-usXX, where usXX is your data center (e.g., us21).

Info

The suffix after the dash (e.g., -us21) identifies your Mailchimp data center. Make sure to copy the entire key including this suffix.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Mailchimp in the list and click on it.

Enter your credentials

Paste your Mailchimp API key into the API Key field and click Connect.

Pipeworks encrypts your key with AES-256-GCM before storing it. The plaintext key is never saved to disk and is only decrypted when your integration container starts.

Start the integration

Click Start to launch the Mailchimp integration container. This takes a few seconds. Once the status shows Running, your agent is ready to use Mailchimp tools.

Test the connection

Use the Test button in your Pipeworks console to verify the connection. This sends a simple API call to Mailchimp to confirm your key works.

What Your Agent Can Do

Once connected, your AI agent has access to Mailchimp tools for:

Audiences — Manage subscriber lists and audience segments
Campaigns — Create, schedule, send, and analyze email campaigns
Templates — Work with email templates
Automations — View and manage automated email workflows
Reports — Access campaign performance data

Tip

Use tool profiles to control what your agent can do. Set the profile to read-only if you only want your agent to retrieve data, not modify anything.

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{
  "mcpServers": {
    "pipeworks-mailchimp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/mailchimp"]
    }
  }
}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Connection test fails? Double-check that you copied the full API key from Mailchimp, including the data center suffix (e.g., -us21).

Container won't start? Make sure your integration is enabled. An admin needs to assign the Mailchimp integration to your workspace first.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Mailchimp to Pipeworks

Prerequisites