Mailchimp Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Mailchimp MCP or direct API to send campaigns, segment audiences, fetch analytics, and manage subscribers through natural language.
BOOK A CALLGET STARTED FOR FREE
Mailchimp Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools and Triggers

Tools
Triggers
Add automationCreate a new classic automation in your mailchimp account.
Add batch webhookConfigure a webhook that will fire whenever any batch request completes processing.
Add campaignCreate a new mailchimp campaign.
Add campaign feedbackAdd feedback on a specific campaign.
Add campaign folderCreate a new campaign folder.
Add cartAdd a new cart to a store.
Add cart line itemAdd a new line item to an existing cart.
Add connected siteCreate a new mailchimp connected site.
Add customerAdd a new customer to a store.
Add domain to accountAdd a domain to the account.
Add eventAdd an event for a list member.
Add exportCreate a new account export in your mailchimp account.
Add fileUpload a new image or file to the file manager.
Add folderCreate a new folder in the file manager.
Add interest categoryCreate a new interest category.
Add interest in categoryCreate a new interest or 'group name' for a specific category.
Add landing pageCreate a new mailchimp landing page.
Add listCreate a new list in your mailchimp account.
Add member noteAdd a new note for a specific subscriber.
Add member to listAdd a new member to the list.
Add member to segmentAdd a member to a static segment.
Add merge fieldAdd a new merge field for a specific audience.
Add orderAdd a new order to a store.
Add order line itemAdd a new line item to an existing order.
Add or remove member tagsAdd or remove tags from a list member.
Add or update customerAdd or update a customer.
Add or update list memberAdd or update a list member.
Add or update product variantAdd or update a product variant.
Add productAdd a new product to a store.
Add product imageAdd a new image to the product.
Add product variantAdd a new variant to the product.
Add promo codeAdd a new promo code to a store.
Add promo ruleAdd a new promo rule to a store.
Add segmentCreate a new segment in a specific list.
Add storeAdd a new store to your mailchimp account.
Add subscriber to workflow emailManually add a subscriber to a workflow, bypassing the default trigger settings.
Add templateCreate a new template for the account.
Add template folderCreate a new template folder.
Add webhookCreate a new webhook for a specific list.
Archive automationArchiving will permanently end your automation and keep the report data.
Archive list memberArchive a list member.
Batch add or remove membersBatch add/remove list members to static segment
Batch subscribe or unsubscribeBatch subscribe or unsubscribe list members.
Campaign abuse report detailsGet information about a specific abuse report for a campaign.
Campaign statistics feedbackGet feedback based on a campaign's statistics.
Cancel campaignCancel a regular or plain-text campaign after you send, before all of your recipients receive it.
Create a survey campaignUtilize the list id and survey id to generate a campaign that links to your survey.
Customer journeys api trigger for a contactCreate a trigger step in the customer journey builder via the api.
Customize signup formCustomize a list's default signup form.
Delete batch requestStops a batch request from running.
Delete batch webhookRemove a batch webhook.
Delete campaignRemove a campaign from your mailchimp account.
Delete campaign feedback messageRemove a specific feedback message for a campaign.
Delete campaign folderDelete a specific campaign folder, and mark all the campaigns in the folder as 'unfiled'.
Delete cartDelete a cart.
Delete cart line itemDelete a specific cart line item.
Delete connected siteRemove a connected site from your mailchimp account.
Delete customerDelete a customer from a store.
Delete domainDelete a verified domain from the account.
Delete fileRemove a specific file from the file manager.
Delete folderDelete a specific folder in the file manager.
Delete interest categoryDelete a specific interest category.
Delete interest in categoryDelete interests or group names in a specific category.
Delete landing pageDelete a landing page.
Delete listDelete a list from your mailchimp account.
Delete list memberDelete all personally identifiable information related to a list member, and remove them from a list.
Delete merge fieldDelete a specific merge field.
Delete noteDelete a specific note for a specific list member.
Delete orderDelete an order.
Delete order line itemDelete a specific order line item.
Delete productDelete a product.
Delete product imageDelete a product image.
Delete product variantDelete a product variant.
Delete promo codeDelete a promo code from a store.
Delete promo ruleDelete a promo rule from a store.
Delete segmentDelete a specific segment in a list.
Delete storeDelete a store.
Delete templateDelete a specific template.
Delete template folderDelete a specific template folder, and mark all the templates in the folder as 'unfiled'.
Delete webhookDelete a specific webhook in a list.
Delete workflow emailRemoves an individual classic automation workflow email.
Get abuse reportGet details about a specific abuse report.
Get account export infoGet information about a specific account export.
Get authorized app infoGet information about a specific authorized application.
Get automated email subscriberGet information about a specific subscriber in a classic automation email queue.
Get automation infoGet a summary of an individual classic automation workflow's settings and content.
Get batch operation statusGet the status of a batch request.
Get batch webhook infoGet information about a specific batch webhook.
Get campaign contentGet the the html and plain-text content for a campaign.
Get campaign feedback messageGet a specific feedback message from a campaign.
Get campaign folderGet information about a specific folder used to organize campaigns.
Get campaign infoGet information about a specific campaign.
Get campaign link detailsGet click details for a specific link in a campaign.
Get campaign recipient infoGet information about a specific campaign recipient.
Get campaign reportGet report details for a specific sent campaign.
Get campaign send checklistReview the send checklist for a campaign, and resolve any issues before sending.
Get cart infoGet information about a specific cart.
Get cart line itemGet information about a specific cart line item.
Get clicked link subscriberGet information about a specific subscriber who clicked a link in a specific campaign.
Get connected siteGet information about a specific connected site.
Get conversationApi endpoint for conversations is deprecated, replaced by inbox.
Get customer infoGet information about a specific customer.
Get domain infoGet the details for a single domain on the account.
Get facebook ad infoGet details of a facebook ad.
Get facebook ad reportGet report of a facebook ad.
Get fileGet information about a specific file in the file manager.
Get folderGet information about a specific folder in the file manager.
Get growth history by monthGet a summary of a specific list's growth activity for a specific month and year.
Get information about all surveys for a listGet information about all available surveys for a specific list.
Get interest category infoGet information about a specific interest category.
Get interest in categoryGet interests or 'group names' for a specific category.
Get landing page contentGet the the html for your landing page.
Get landing page infoGet information about a specific page.
Get landing page reportGet report of a landing page.
Get latest chimp chatterReturn the chimp chatter for this account ordered by most recent.
Get list infoGet information about a specific list in your mailchimp account.
Get lists infoGet information about all lists in the account.
Get member infoGet information about a specific list member, including a currently subscribed, unsubscribed, or bounced member.
Get member noteGet a specific note for a specific list member.
Get merge fieldGet information about a specific merge field.
Get messageThe conversation endpoint is outdated and replaced by inbox, which isn't supported by it.
Get opened campaign subscriberGet information about a specific subscriber who opened a campaign.
Get order infoGet information about a specific order.
Get order line itemGet information about a specific order line item.
Get product image infoGet information about a specific product image.
Get product infoGet information about a specific product.
Get product variant infoGet information about a specific product variant.
Get promo codeGet information about a specific promo code.
Get promo ruleGet information about a specific promo rule.
Get segment infoGet information about a specific segment.
Get store infoGet information about a specific store.
Get subscriber email activityGet a specific list member's activity in a campaign including opens, clicks, and bounces.
Get subscriber removed from workflowGet information about a specific subscriber who was removed from a classic automation workflow.
Get surveyGet details about a specific survey.
Get survey question reportGet report for a survey question.
Get survey reportGet report for a survey.
Get survey responseGet a single survey response.
Get template folderGet information about a specific folder used to organize templates.
Get template infoGet information about a specific template.
Get unsubscribed memberGet information about a specific list member who unsubscribed from a campaign.
Get webhook infoGet information about a specific webhook.
Get workflow email infoGet information about an individual classic automation workflow email.
List abuse reportsGet all abuse reports for a specific list.
List account exportsGet a list of account exports for a given account.
List account ordersGet information about an account's orders.
List answers for questionGet answers for a survey question.
List api root resourcesGet links to all other resources available in the api.
List authorized appsGet a list of an account's registered, connected applications.
List automated emailsGet a summary of the emails in a classic automation workflow.
List automated email subscribersGet information about a classic automation email queue.
List automationsGet a summary of an account's classic automations.
List batch requestsGet a summary of batch requests that have been made.
List batch webhooksGet all webhooks that have been configured for batches.
List campaign detailsGet information about clicks on specific links in your mailchimp campaigns.
List campaign feedbackGet team feedback while you're working together on a mailchimp campaign.
List campaign foldersGet all folders used to organize campaigns.
List campaign open detailsGet detailed information about any campaign emails that were opened by a list member.
List campaign product activityGet breakdown of product activity for a campaign
List campaign recipientsGet information about campaign recipients.
List campaign reportsGet campaign reports.
List campaignsGet all campaigns in an account.
List cart line itemsGet information about a cart's line items.
List cartsGet information about a store's carts.
List child campaign reportsGet a list of reports with child campaigns for a specific parent campaign.
List clicked link subscribersGet information about list members who clicked on a specific link in a campaign.
List connected sitesGet all connected sites in an account.
List conversationsList of conversations for an account is available via an endpoint, but it's deprecated in favor of inbox.
List customersGet information about a store's customers.
List domain performance statsGet statistics for the top-performing email domains in a campaign.
List eepurl activityGet a summary of social activity for the campaign, tracked by eepurl.
List email activityGet a list of member's subscriber activity in a specific campaign.
List facebook adsGet list of facebook ads.
List facebook ads reportsGet reports of facebook ads.
List facebook ecommerce reportGet breakdown of product activity for an outreach.
List foldersGet a list of all folders in the file manager.
List growth history dataGet a month-by-month summary of a specific list's growth activity.
List interest categoriesGet information about a list's interest categories.
List interests in categoryGet a list of this category's interests.
List landing pagesGet all landing pages.
List landing pages reportsGet reports of landing pages.
List locationsGet the locations (countries) that the list's subscribers have been tagged to based on geocoding their ip address.
List member eventsGet events for a contact.
List member goal eventsGet the last 50 goal events for a member on a specific list.
List members infoGet information about members in a specific mailchimp list.
List members in segmentGet information about members in a saved segment.
List member tagsGet the tags on a list member.
List merge fieldsGet a list of all merge fields for an audience.
List messagesLegacy "conversations" endpoint is deprecated; use "inbox" for new messages.
List order line itemsGet information about an order's line items.
List ordersGet information about a store's orders.
List productGet information about a store's products.
List product imagesGet information about a product's images.
List product variantsGet information about a product's variants.
List promo codesGet information about a store's promo codes.
List promo rulesGet information about a store's promo rules.
List recent activityGet up to the previous 180 days of daily detailed aggregated activity stats for a list, not including automation activity.
List recent member notesGet recent notes for a specific list member.
List segmentsGet information about all available segments for a specific list.
List sending domainsGet all of the sending domains on the account.
List signup formsGet signup forms for a specific list.
List stored filesGet a list of available images and files stored in the file manager for the account.
List storesGet information about all stores in the account.
List subscribers removed from workflowGet information about subscribers who were removed from a classic automation workflow.
List survey question reportsGet reports for survey questions.
List survey reportsGet reports for surveys.
List survey responsesGet responses to a survey.
List template foldersGet all folders used to organize templates.
List templatesGet a list of an account's available templates.
List top email clientsGet a list of the top email clients based on user-agent strings.
List top open activitiesGet top open locations for a specific campaign.
List unsubscribed membersGet information about members who have unsubscribed from a specific campaign.
List webhooksGet information about all webhooks for a specific list.
Pause automated emailPause an automated email.
Pause automation emailsPause all emails in a specific classic automation workflow.
Pause rss campaignPause an rss-driven campaign.
PingA health check for the api that won't return any account-specific information.
Publish a surveyPublish a survey that is in draft, unpublished, or has been previously published and edited.
Publish landing pagePublish a landing page that is in draft, unpublished, or has been previously published and edited.
Remove list member from segmentRemove a member from the specified static segment.
Remove subscriber from workflowRemove a subscriber from any point in a classic automation workflow; once removed, they cannot be re-added to that workflow.
Replicate campaignReplicate a campaign in saved or send status.
Resend campaignRemove the guesswork for resending a campaign to certain segments.
Resume rss campaignResume an rss-driven campaign.
Retrieve campaign abuse complaintsGet a list of abuse complaints for a specific campaign.
Retrieve folder contentsGet a list of available images and files stored in this folder.
Schedule campaignSchedule a campaign for delivery.
Search campaignsSearch all campaigns for the specified query terms.
Search for tags on a list by nameSearch for tags on a list by name.
Search membersSearch for list members.
Send campaignSend a mailchimp campaign.
Send test emailSend a test email.
Set campaign contentSet the content for a campaign.
Start automated emailStart an automated email.
Start automation emailsStart all emails in a classic automation workflow.
Start batch operationBegin processing a batch operations request.
Unpublish a surveyUnpublish a survey that has been published.
Unpublish landing pageUnpublish a landing page that is in draft or has been published.
Unschedule campaignUnschedule a scheduled campaign that hasn't started sending.
Update batch webhookUpdate a webhook that will fire whenever any batch request completes processing.
Update campaign feedback messageUpdate a specific feedback message for a campaign.
Update campaign folderUpdate a specific folder used to organize campaigns.
Update campaign settingsUpdate some or all of the settings for a specific campaign.
Update cartUpdate a specific cart.
Update cart line itemUpdate a specific cart line item.
Update customerUpdate a customer.
Update fileUpdate a file in the file manager.
Update folderUpdate a specific file manager folder.
Update interest categoryUpdate a specific interest category.
Update interest in categoryUpdate interests or 'group names' for a specific category.
Update landing pageUpdate a landing page.
Update list memberUpdate information for a specific list member.
Update listsUpdate the settings for a specific list.
Update merge fieldUpdate a specific merge field.
Update noteUpdate a specific note for a specific list member.
Update orderUpdate a specific order.
Update order line itemUpdate a specific order line item.
Update productUpdate a specific product.
Update product imageUpdate a product image.
Update product variantUpdate a product variant.
Update promo codeUpdate a promo code.
Update promo ruleUpdate a promo rule.
Update storeUpdate a store.
Update templateUpdate the name, html, or `folder id` of an existing template.
Update template folderUpdate a specific folder used to organize templates.
Update webhookUpdate the settings for an existing webhook.
Update workflow emailUpdate settings for a classic automation workflow email.
Verify connected site scriptVerify that the connected sites script has been installed, either via the script url or fragment.
Verify domainVerify a domain for sending.
View default contentGet the sections that you can edit in a template, including each section's default content.
View recent activityGet a member's activity on a specific list, including opens, clicks, and unsubscribes.
View recent activity 50Get the last 50 events of a member's activity on a specific list, including opens, clicks, and unsubscribes.

Connect Mailchimp MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Mailchimp tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new Mailchimp campaign for our June newsletter')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Mailchimp API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Mailchimp Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Send a new campaign to my newsletter list announcing a product launch'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Mailchimp actions with your Agent

Why Use Composio?

AI Native Mailchimp Integration

  • Supports both Mailchimp MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Mailchimp data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Mailchimp access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Mailchimp
  • Scoped, least privilege access to Mailchimp resources
  • Full audit trail of agent actions to support review and compliance

Use Mailchimp with any AI Agent Framework

Choose a Framework you want to connect Mailchimp with

Frequently Asked Questions

Do I need my own developer credentials to use Mailchimp with Composio?

No, you can get started immediately using Composio's built-in Mailchimp app. For production, we recommend configuring your own OAuth credentials.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free