Mailchimp MCP Server

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 密钥

1. 登录 Mailchimp
2. 前往 Account & Billing > Extras > API Keys
3. 点击 Create A Key
4. 复制密钥（格式：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	启动工作流中的所有电子邮件

Webhook（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 显示每月订阅／取消订阅趋势。

“哪个营销活动带来了最多收入？”

使用带有 campaign_id 的 list_store_orders 查看各营销活动的收入归因。

“显示我的 Shopify 商店中的弃购购物车”

使用 list_store_carts 查找挽回机会。

“给 [email protected] 添加一条备注，说明他打电话询问了价格”

使用 add_member_note 进行 CRM 式联系人管理。

“哪个 A/B 测试的主题行胜出？”

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

“我的订阅者都位于哪些地区？”

使用 get_audience_locations 查看地理分布。

要求

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

开发

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

许可证

MIT