Mailchimp MCP Server

mcp-mailchimp

Mailchimp Marketing API 用の本番環境対応 MCP サーバーです。キャンペーン、オーディエンス、メンバー、タグ、セグメント、テンプレート、レポート、自動化、Webhook、マージフィールド、興味グループ、ランディングページ、バッチ操作、Eコマース、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 キーを取得する

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	キャンペーン設定（件名、from_name など）を更新します
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を削除します

Eコマース（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操作を1つのバッチで送信します

例

「最近送信したキャンペーンは？」

list_campaigns を status=sent で使用して、開封数とクリック数の統計情報とともに最近のキャンペーンを表示します。

「今四半期、オーディエンスはどのように増加しましたか？」

get_audience_growth を使用して、月ごとの登録・登録解除の傾向を表示します。

「最も売上をもたらしたキャンペーンは？」

list_store_orders を campaign_id とともに使用して、キャンペーンごとの売上貢献度を確認します。

「Shopifyストアの放棄されたカートを表示して」

list_store_carts を使用して、リカバリーの機会を見つけます。

「[email protected]に、価格について電話があったとメモを追加して」

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