AI导哈

邮件营销API服务

一个生产级的Mailchimp营销API服务器，提供71种工具覆盖邮件营销全流程，适用于邮件营销、客户关系管理和电子商务场景。

  • by AlexlaGuardia
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 AlexlaGuardia/mcp-mailchimp

使用说明

mcp mailchimp

生产级MCP服务器 Mailchimp营销API.71个工具，涵盖活动、受众、成员、标签、细分、模板、报告、自动化、webhooks、合并字段、兴趣组、登录页面、批处理操作、电子商务、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. 登录 邮件猩猩
  2. 首选 账户和账单 > 额外内容 > API密钥
  3. 点击 创建密钥
  4. 复制密钥（格式： xxxxxxxxxx-usXX)

3.配置您的客户端

克劳德桌面版 (claude_desktop_config.json):

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

克劳德代码：

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

光标 (.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 点击详情——点击了哪些网址以及点击频率
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 为受众列出webhooks
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兼容客户端（克劳德桌面、克劳德代码、光标等）

发展

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

许可证

麻省理工学院

相关 MCP