mailchimp_list_campaigns

List Mailchimp Campaigns

Mailchimp

Description

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.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "mailchimp_list_campaigns",
    "arguments": {
      "reason": "List all campaigns"
    }
  }
}

Parameters

NameTypeRequiredDescription
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (5)
NameTypeRequiredDescription
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