mailchimp_list_campaigns
List Mailchimp Campaigns
MailchimpDescription
List campaigns in the Mailchimp account with status filtering, server-side title search, sorting, date range filtering, and pagination. When the search parameter is provided (without a cursor), routes to Mailchimp's /search-campaigns endpoint for accurate server-side matching sorted by most recent send_time — ideal for campaign disambiguation by title. Results include web_id, audience name, and send_time for easy identification. Use sort_field=send_time with sort_dir=DESC to get the most recently sent campaigns first. Use since_send_time/before_send_time to filter by send date window.
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "mailchimp_list_campaigns",
"arguments": {
"reason": "List all campaigns"
}
}
}
hopkin mailchimp -campaigns
| Flag | Type | Required | Description |
|---|---|---|---|
--account | string | Optional | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
--campaign | string | Optional | The Mailchimp campaign ID. Required unless web_id is provided. |
--web-id | integer | Optional | Alternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence. |
--include-content | boolean | Optional | Include a preview of the campaign HTML/text content (truncated to 5000 chars). |
--include-send-checklist | boolean | Optional | Include the send checklist for the campaign. |
{
"mcpServers": {
"mailchimp": {
"url": "https://mailchimp.mcp.hopkin.ai",
"transport": "sse"
}
}
}
- List all
- Filter by status
- Search
- Latest sent
- Recent window
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (5)
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
string |
Optional | Mailchimp account ID. Required when multiple accounts are connected. Use mailchimp_list_accounts to see available accounts. |
campaign_id |
string |
Optional | The Mailchimp campaign ID. Required unless web_id is provided. |
web_id |
integer |
Optional | Alternative to campaign_id: the numeric web_id from Mailchimp UI URLs. If both are provided, campaign_id takes precedence. |
include_content |
boolean |
Optional | Include a preview of the campaign HTML/text content (truncated to 5000 chars). |
include_send_checklist |
boolean |
Optional | Include the send checklist for the campaign. |
Examples
List all
{
"reason": "List all campaigns"
}
hopkin mailchimp -campaigns
Filter by status
{
"status": [
"sent",
"sending"
],
"reason": "List sent campaigns"
}
hopkin mailchimp -campaigns --status sent,sending
Search
{
"search": "Welcome",
"reason": "Find welcome campaigns"
}
hopkin mailchimp -campaigns --search Welcome
Latest sent
{
"status": [
"sent"
],
"sort_field": "send_time",
"sort_dir": "DESC",
"limit": 10,
"reason": "Get 10 most recently sent campaigns"
}
hopkin mailchimp -campaigns --status sent --sort-field send_time --sort-dir DESC --limit 10
Recent window
{
"status": [
"sent"
],
"sort_field": "send_time",
"sort_dir": "DESC",
"since_send_time": "2025-04-01T00:00:00Z",
"reason": "Campaigns sent since April 2025"
}
hopkin mailchimp -campaigns --status sent --sort-field send_time --sort-dir DESC --since-send-time 2025-04-01T00:00:00Z