mcp-mailchimp

Mailchimp Marketing API를 위한 프로덕션급 MCP 서버입니다. 캠페인, 오디언스, 멤버, 태그, 세그먼트, 템플릿, 보고서, 자동화, 웹훅, 병합 필드, 관심사 그룹, 랜딩 페이지, 배치 작업, 이커머스, A/B 테스트, 멤버 노트, 파일 관리자 및 오디언스 분석을 아우르는 71개의 도구를 제공합니다.

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`	새 구독자 추가 또는 기존 구독자 업데이트(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`	이메일 주소로 정적 세그먼트 생성
`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`	워크플로우의 모든 이메일 시작

웹훅 (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 작업 제출

예시

"최근에 보낸 캠페인은 무엇인가요?"

status=sent와 함께 list_campaigns를 사용하여 열람/클릭 통계가 포함된 최근 캠페인을 보여줍니다.

"이번 분기에 오디언스가 얼마나 성장했나요?"

get_audience_growth를 사용하여 월별 구독/수신 거부 추세를 보여줍니다.

"어떤 캠페인이 가장 많은 수익을 창출했나요?"

campaign_id와 함께 list_store_orders를 사용하여 캠페인별 수익 기여도를 확인합니다.

"Shopify 스토어에서 장바구니를 이탈한 내역을 보여주세요"

list_store_carts를 사용하여 복구 기회를 찾습니다.

"john@example.com에게 가격 문의를 했다는 메모를 추가하세요"

CRM 스타일의 연락처 관리를 위해 add_member_note를 사용합니다.

"어떤 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