mcp-mailchimp

用于 Mailchimp Marketing API 的生产级 MCP 服务器。包含 71 种工具，涵盖营销活动、受众、成员、标签、细分、模板、报告、自动化、Webhook、合并字段、兴趣组、落地页、批量操作、电子商务、A/B 测试、成员备注、文件管理器和受众分析。

专为 Claude Desktop、Claude Code、Cursor 以及任何兼容 MCP 的客户端构建。

快速入门

1. 安装

pip install mcp-mailchimp

或从源码安装：

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install .

2. 获取 API 密钥

登录 Mailchimp
前往 Account & Billing > Extras > API Keys
点击 Create A Key
复制密钥（格式：xxxxxxxxxx-usXX）

3. 配置客户端

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code:

claude mcp add mailchimp -- env MAILCHIMP_API_KEY=your-key mcp-mailchimp

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "mailchimp": {
      "command": "mcp-mailchimp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

或直接运行：

MAILCHIMP_API_KEY=your-key mcp-mailchimp

工具 (71)

账户 (1)

工具	描述
`ping`	验证 API 密钥并获取账户信息

营销活动 (11)

工具	描述
`list_campaigns`	列出带有状态/受众过滤器的营销活动
`get_campaign`	获取营销活动详情（设置、跟踪、收件人）
`create_campaign`	创建新的电子邮件营销活动
`update_campaign`	更新营销活动设置（主题、发件人名称等）
`send_campaign`	立即发送营销活动
`schedule_campaign`	为特定时间安排营销活动
`unschedule_campaign`	取消已安排的营销活动
`cancel_campaign`	取消当前正在发送的营销活动
`delete_campaign`	永久删除草稿营销活动
`replicate_campaign`	复制现有的营销活动
`send_test_email`	向指定地址发送测试邮件

营销活动内容 (2)

工具	描述
`get_campaign_content`	获取营销活动的 HTML 和纯文本内容
`set_campaign_content`	通过 HTML 或模板设置内容

报告 (5)

工具	描述
`get_campaign_report`	性能报告（打开、点击、退信、退订）
`get_click_report`	点击详情——哪些 URL 被点击以及点击频率
`get_open_report`	打开详情——哪些订阅者打开了邮件以及何时打开
`get_unsubscribe_report`	退订详情——谁离开了以及原因
`get_sent_to_report`	投递详情——收件人状态（已发送、已退信）

受众 (4)

工具	描述
`list_audiences`	列出所有受众及其订阅者数量
`get_audience`	获取受众详情和统计信息
`create_audience`	创建新的受众/列表
`update_audience`	更新受众设置

受众分析 (3)

工具	描述
`get_audience_growth`	每月增长历史——订阅、退订、净变化
`get_audience_locations`	按国家/地区划分的订阅者位置分布
`get_email_client_stats`	电子邮件域性能——Gmail、Outlook、Apple Mail 分布

成员 (8)

工具	描述
`list_members`	按状态列出/过滤受众成员
`get_member`	按电子邮件获取订阅者详情
`add_or_update_member`	添加新订阅者或更新现有订阅者（插入或更新）
`archive_member`	归档（软删除）订阅者
`delete_member_permanent`	永久删除订阅者（不可逆）
`batch_subscribe_members`	一次批量订阅最多 500 名成员
`search_members`	在所有受众中搜索成员
`get_member_activity`	最近的订阅者活动（打开、点击等）

成员备注 (2)

工具	描述
`list_member_notes`	列出订阅者的 CRM 风格备注
`add_member_note`	为订阅者添加备注

标签 (2)

工具	描述
`list_tags`	列出受众的所有标签
`manage_member_tags`	添加或移除订阅者的标签

细分 (5)

工具	描述
`list_segments`	列出受众的已保存细分
`get_segment_members`	列出细分中的成员
`create_segment`	从电子邮件地址创建静态细分
`update_segment`	更新细分名称或添加/移除成员
`delete_segment`	删除细分

合并字段 (2)

工具	描述
`list_merge_fields`	列出自定义字段（FNAME、LNAME、自定义）
`create_merge_field`	创建自定义合并字段（文本、数字、日期等）

兴趣类别与组 (2)

工具	描述
`list_interest_categories`	列出兴趣组（复选框、下拉菜单、单选按钮）
`list_interests`	列出类别内的各个选项

模板 (4)

工具	描述
`list_templates`	列出可用的电子邮件模板
`get_template`	获取模板详情和 HTML 内容
`create_template`	从 HTML 创建新模板
`delete_template`	删除自定义模板

自动化 (5)

工具	描述
`list_automations`	列出经典自动化
`get_automation`	获取自动化详情和触发信息
`list_automation_emails`	列出自动化工作流中的所有电子邮件
`pause_automation`	暂停工作流中的所有电子邮件
`start_automation`	启动工作流中的所有电子邮件

Webhooks (3)

工具	描述
`list_webhooks`	列出受众的 Webhook
`create_webhook`	为受众事件创建 Webhook
`delete_webhook`	删除 Webhook

电子商务 (6)

工具	描述
`list_ecommerce_stores`	列出已连接的商店（Shopify、WooCommerce 等）
`list_store_products`	列出已连接商店中的产品
`list_store_orders`	列出订单——按营销活动过滤以进行收入归因
`get_ecommerce_customer`	获取包含订单数量和总消费额的客户详情
`list_store_carts`	列出用于挽回营销活动的废弃购物车
`list_store_promo_codes`	列出促销规则的促销代码

A/B 测试 (1)

工具	描述
`get_ab_test_results`	获取变体营销活动结果——哪个组合获胜

落地页 (2)

工具	描述
`list_landing_pages`	列出带有访问/转化统计信息的落地页
`get_landing_page`	获取落地页详情和跟踪数据

文件管理器 (2)

工具	描述
`list_files`	列出 Mailchimp 文件管理器中的文件
`upload_file`	上传文件（Base64 编码）

批量操作 (1)

工具	描述
`create_batch_operation`	在单个批次中提交最多 500 个 API 操作

示例

“我最近发送了哪些营销活动？”

使用 list_campaigns 和 status=sent 来显示带有打开/点击统计信息的近期营销活动。

“本季度我的受众增长情况如何？”

使用 get_audience_growth 来显示每月的订阅/退订趋势。

“哪个营销活动带来的收入最高？”

使用 list_store_orders 和 campaign_id 来查看每个营销活动的收入归因。

“向我展示来自 Shopify 商店的废弃购物车”

使用 list_store_carts 来寻找挽回机会。

“给 john@example.com 添加一条备注，说明他询问过定价”

使用 add_member_note 进行 CRM 风格的联系人管理。

“哪个 A/B 测试主题行获胜了？”

使用 get_ab_test_results 查看哪个变体表现最好。

“我的订阅者位于哪里？”

使用 get_audience_locations 进行地理分布分析。

要求

Python 3.10+
拥有 API 密钥的 Mailchimp 账户
兼容 MCP 的客户端（Claude Desktop、Claude Code、Cursor 等）

开发

git clone https://github.com/AlexlaGuardia/mcp-mailchimp.git
cd mcp-mailchimp
pip install -e ".[dev]"
pytest

许可证

MIT

Mailchimp MCP Server