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キーの取得

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`	新規購読者の追加または既存の更新（アップサート）
`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操作を単一のバッチで送信

例

「最近送信したキャンペーンは何ですか？」

status=sent を指定して list_campaigns を使用し、開封/クリック統計を含む最近のキャンペーンを表示します。

「今四半期のオーディエンスの成長状況は？」

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

「どのキャンペーンが最も収益を上げましたか？」

campaign_id を指定して list_store_orders を使用し、キャンペーンごとの収益帰属を確認します。

「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互換クライアント（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