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密钥
- 登录 邮件猩猩
- 首选 账户和账单 > 额外内容 > API密钥
- 点击 创建密钥
- 复制密钥（格式：
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）
活动（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
许可证
麻省理工学院
