mcp-mailchimp

MCP-сервер промышленного уровня для Mailchimp Marketing API. 71 инструмент для работы с кампаниями, аудиториями, подписчиками, тегами, сегментами, шаблонами, отчетами, автоматизациями, вебхуками, полями слияния, группами интересов, целевыми страницами, пакетными операциями, электронной коммерцией, 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`	Создание новой email-кампании
`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`	Получение деталей подписчика по email
`add_or_update_member`	Добавление нового или обновление существующего подписчика (upsert)
`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`	Создание статического сегмента из email-адресов
`update_segment`	Обновление названия сегмента или добавление/удаление подписчиков
`delete_segment`	Удаление сегмента

Поля слияния (2)

Инструмент	Описание
`list_merge_fields`	Список пользовательских полей (FNAME, LNAME, custom)
`create_merge_field`	Создание пользовательского поля слияния (текст, число, дата и т.д.)

Категории интересов и группы (2)

Инструмент	Описание
`list_interest_categories`	Список групп интересов (флажки, выпадающие списки, радиокнопки)
`list_interests`	Список отдельных опций внутри категории

Шаблоны (4)

Инструмент	Описание
`list_templates`	Список доступных email-шаблонов
`get_template`	Получение деталей шаблона и HTML-контента
`create_template`	Создание нового шаблона из HTML
`delete_template`	Удаление пользовательского шаблона

Автоматизации (5)

Инструмент	Описание
`list_automations`	Список классических автоматизаций
`get_automation`	Получение деталей автоматизации и информации о триггере
`list_automation_emails`	Список всех писем в рабочем процессе автоматизации
`pause_automation`	Приостановка всех писем в рабочем процессе
`start_automation`	Запуск всех писем в рабочем процессе

Вебхуки (3)

Инструмент	Описание
`list_webhooks`	Список вебхуков для аудитории
`create_webhook`	Создание вебхука для событий аудитории
`delete_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+
Аккаунт 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

Mailchimp MCP Server