Mailchimp Mcp Server

Mailchimp MCP サーバー

Mailchimp Marketing API 向けの、最も包括的な Model Context Protocol (MCP) サーバーです。227 個のツールを備え、MCP 対応クライアントから Mailchimp アカウントを照会・管理できます。キャンペーン、オーディエンス、メンバー、セグメント、自動化、レポート機能全般を網羅し、完全な E コマース機能（読み取りと書き込み）、ランディングページ、ファイルマネージャー、アンケート、登録フォーム、認証済みドメインに加え、複数アカウントのサポートと実行時セキュリティガードレール（読み取り専用、ドライラン、監査モード、およびツールごとのリスクメタデータ）を備えています。

requests を介して Mailchimp Marketing API を使用します。公式の mailchimp-marketing-python クライアントをベースにしていません。問題が多すぎたため、代わりに生の HTTP 呼び出しを使うことにしました。

クイックスタート

uvx mailchimp-mcp   # no install required; just needs MAILCHIMP_API_KEY

MCP クライアント（Claude Desktop、Cursor、Cline など）に追加します。

{
  "mcpServers": {
    "mailchimp": {
      "command": "uvx",
      "args": ["mailchimp-mcp"],
      "env": {
        "MAILCHIMP_API_KEY": "your-key-us8",
        "MAILCHIMP_READ_ONLY": "true"
      }
    }
  }
}

ヒント：まず MAILCHIMP_READ_ONLY=true にして安全に試し、書き込みを行う準備ができたらオフにしてください。すべてのオプションについては、設定を参照してください。

Docker

リリースのたびに、ビルド済みイメージが GitHub Container Registry に公開されます。

docker run --rm -i -e MAILCHIMP_API_KEY=your-key-us8 ghcr.io/damientilman/mailchimp-mcp-server:latest

または、MCP クライアントから接続します。

{
  "mcpServers": {
    "mailchimp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "MAILCHIMP_API_KEY", "-e", "MAILCHIMP_READ_ONLY", "ghcr.io/damientilman/mailchimp-mcp-server:latest"],
      "env": {
        "MAILCHIMP_API_KEY": "your-key-us8",
        "MAILCHIMP_READ_ONLY": "true"
      }
    }
  }
}

機能

読み取り

• キャンペーン - キャンペーンの一覧表示、検索、詳細の確認
• レポート - 開封率／クリック率、バウンス、リンクごとのクリック数、ドメイン別のパフォーマンス、配信停止の詳細
• メールアクティビティ - 受信者ごとの開封／クリック追跡、メンバーのアクティビティ履歴
• オーディエンス - オーディエンス、メンバー、セグメント、タグ、成長履歴の閲覧
• マージフィールド - オーディエンスのカスタムフィールドの一覧表示
• インタレストカテゴリとグループ - インタレストカテゴリと選択肢の閲覧
• Webhook - 設定済みのWebhookの一覧表示
• セグメント - セグメントの詳細、条件、メンバーリストの取得
• 自動化 - ワークフローの一覧表示、ワークフロー内のメールの確認、キューの表示
• テンプレート - テンプレートの閲覧とHTMLコンテンツの抽出
• ランディングページ - ランディングページの一覧表示と詳細の確認
• ファイルマネージャー - 保存済みの画像、ファイル、フォルダーの閲覧
• アンケート - オーディエンスのアンケートの一覧表示と詳細の確認
• 登録フォーム - オーディエンスの登録フォームの詳細確認
• Eコマース - ストア、注文、商品、顧客（Eコマース連携が必要）
• キャンペーンフォルダー - フォルダー構成の閲覧
• バッチ処理 - 一括操作のステータスの監視

書き込み

• メンバー - 連絡先の追加、更新、配信停止、削除、タグ付け
• オーディエンス - メンバーの一括登録、オーディエンス設定の更新
• キャンペーン - 下書きの作成、HTMLコンテンツの設定、スケジュール設定、スケジュール解除、複製、削除、送信、テスト送信、キャンセル
• セグメント／タグ - 作成、更新、削除、メンバーの追加／削除、動的条件の設定
• マージフィールド - カスタムフィールドの作成、更新、削除
• インタレストカテゴリ - カテゴリとインタレストの作成、削除
• Webhook - Webhookの作成、削除
• テンプレート - メールテンプレートの作成、更新、削除
• ファイルマネージャー - 画像とファイルのアップロード（base64）、削除
• アンケート - オーディエンスのアンケートの公開、非公開
• 登録フォーム - ヘッダー、コンテンツ、スタイルのカスタマイズ
• 自動化 - 自動化ワークフローの一時停止、開始
• Eコマース - 割引ワークフロー向けのカートライフサイクル、プロモーションルール、プロモーションコード
• バッチ - 1 回のリクエストでAPI操作を一括実行

ランタイムセキュリティ

• リスクメタデータ - MCP アノテーションと describe_tools による、ツールごとの読み取り／書き込み／破壊的操作の分類
• 監査ログ - ディスパッチごとの構造化JSON監査イベント（任意）（MAILCHIMP_AUDIT_LOG）
• 引数の検証 - 各リクエストの前にページネーション上限と必須IDを確認

前提条件

• Python 3.10+
• Mailchimp API key

インストール

uvx を使用する場合（推奨）

インストールは不要です。直接実行できます。

uvx mailchimp-mcp

pip を使用する場合

pip install mailchimp-mcp

次に、以下を実行します。

mailchimp-mcp

ソースから

git clone https://github.com/damientilman/mailchimp-mcp-server.git
cd mailchimp-mcp-server
python -m venv .venv
source .venv/bin/activate
pip install -e .

設定

データセンター（us8、us21 など）は、各キーから自動的に抽出されます。

安全モード

読み取り専用モード — MAILCHIMP_READ_ONLY=true の場合、すべての書き込みツール（作成、更新、削除、スケジュール設定など）はブロックされ、エラーを返します。読み取りツールは通常どおり動作します。レポートと分析だけが必要な共有環境や試験的なセットアップでは、これを推奨するデフォルト設定とします。

ドライランモード — MAILCHIMP_DRY_RUN=true の場合、書き込みツールは API を呼び出さずに、実行する場合のアクションのプレビュー（ツール名、対象リソース、パラメーター、リスク階層）を返します。実際に運用を開始する前にプロンプトをテストするのに便利です。

実行時のセキュリティ

このサーバーは、外部 MCP ゲートウェイと連携した多層防御を想定して設計されています。どのツールが読み取り、取り消し可能な書き込み、取り消し不可能な操作に当たるかという意味づけをサーバーが担い、ゲートウェイが危険な呼び出しを推測するのではなく、ゲートウェイが強制適用できる機械可読なシグナルとして公開します。

リスクメタデータ — すべてのツールは、read、write、destructive（取り消し不可能なデータ損失または取り消し不可能な送信）のいずれかに分類されています。この情報は、次の 2 つの方法で提供されます。

• MCP ツールのアノテーション — readOnlyHint、destructiveHint、idempotentHint は標準の tools/list を通じて渡されるため、準拠するクライアントやゲートウェイはそれらを直接読み取れます。
• describe_tools — すべてのツールについて {name, risk, read_only, destructive, idempotent} と階層ごとの件数を返す読み取りツールです。ツール呼び出しを利用するゲートウェイ向けです。

構造化監査ログ — MAILCHIMP_AUDIT_LOG=true の場合、各ディスパッチで、ツール、リスク階層、destructive フラグ、対象アカウント、結果（executed／blocked_read_only／dry_run）、検査済みの引数を含む JSON イベントが stderr に 1 件出力されます。サイズの大きい値や機密性の高い値（base64 の file_data など）はマスキングされ、レスポンス本文はログに記録されないため、このストリームは一元的に tail できる安全な監査ログの出力先になります。

引数コントラクトの検証 — すべての書き込みは単一の _guard_write チョークポイントを通り、すべてのリクエストはディスパッチ前に検証されます（ページネーションの count は 1～1000 に制限され、欠落しているパス ID は拒否されます）。これにより、不正な呼び出しは API に到達する前に、一貫した形ですばやく失敗します。

ツールプロファイル

227 個すべてのツールを公開すると、モデルに毎ターン大量のツール一覧（約 63k トークン）が送信されます。必要な範囲だけを読み込むには、1 行で設定できます。

"env": { "MAILCHIMP_API_KEY": "your-key-us8", "MAILCHIMP_TOOLS": "read" }

MAILCHIMP_TOOLS には、リスク階層（read、write、destructive）および／または正確なツール名をカンマ区切りで指定できます。どちらかに一致したツールが含まれます。未設定（または all）の場合は、すべてのツールが公開されます。

• read — レポートと分析のみ（約 115 個のツール、約 29k トークン）。調査に適した安全で軽量なデフォルト設定です。
• read,write — 取り消し不可能なツールを除くすべて。
• list_campaigns,get_campaign_report,send_campaign — 厳選した最小限のセット。

ツールの説明からは、モデルに渡す前に繰り返しの定型文も削除されるため、全セットでも元の docstring より簡潔です。各ツールのリスク階層を確認するには、describe_tools を使用してください。

複数アカウント

デフォルトでは、サーバーは単一の MAILCHIMP_API_KEY を使用し、これを default アカウントとして公開します。1 台のサーバーから複数の Mailchimp アカウントを管理するには、MAILCHIMP_API_KEY_<NAME> 変数を追加します。サフィックスが小文字のアカウント名になります（例：MAILCHIMP_API_KEY_MARKETING → marketing）。

その後、すべてのツールで省略可能な account 引数が利用できるようになります。例：list_audiences(account="marketing")。選択は呼び出しごとに行われ、ステートレスです。「現在のアカウント」を切り替える仕組みはないため、書き込みでは必ず対象を指定します。account を省略すると default が使用されます。設定済みのアカウント名と安全フラグの状態を確認するには、list_accounts を呼び出してください。また、各アカウントにはそれぞれ独自の MAILCHIMP_READ_ONLY_<NAME>／MAILCHIMP_DRY_RUN_<NAME> フラグを設定できるため、書き込みを保護したアカウントと書き込み可能なアカウントを併用できます。不明な account を指定すると、設定済みの名前を列挙したエラーが返されます。

単一キーのセットアップには影響しません。MAILCHIMP_API_KEY だけが設定されている場合、動作に変更はありません。

{
  "mcpServers": {
    "mailchimp": {
      "command": "uvx",
      "args": ["mailchimp-mcp"],
      "env": {
        "MAILCHIMP_API_KEY": "your-default-key-us8",
        "MAILCHIMP_API_KEY_MARKETING": "another-key-us5",
        "MAILCHIMP_READ_ONLY_MARKETING": "true"
      }
    }
  }
}

MCP クライアントの設定

ほとんどの MCP クライアントでは、サーバーの起動方法を記述した JSON 設定ブロックを使用できます。 環境で MAILCHIMP_API_KEY をエクスポートしたうえで、uvx mailchimp-mcp（または pip でインストールした場合は mailchimp-mcp）を実行するように設定してください。

{
  "mcpServers": {
    "mailchimp": {
      "command": "uvx",
      "args": ["mailchimp-mcp"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "mailchimp": {
      "command": "mailchimp-mcp",
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "mailchimp": {
      "command": "uvx",
      "args": ["mailchimp-mcp"],
      "env": {
        "MAILCHIMP_API_KEY": "your-api-key-here",
        "MAILCHIMP_READ_ONLY": "true"
      }
    }
  }
}

CLI ベースのクライアント

MCP クライアントにサーバーを登録する CLI がある場合、同等の実行方法は次のとおりです。

mcp-cli add mailchimp \
  -e MAILCHIMP_API_KEY=your-api-key-here \
  -- uvx mailchimp-mcp

mcp-cli をお使いのクライアントのバイナリ名に置き換えてください。読み取り専用モードにするには、コマンドに -e MAILCHIMP_READ_ONLY=true を追加します。

利用可能なツール

アカウント

キャンペーン（読み取り）

キャンペーンレポート

キャンペーン（書き込み）

オーディエンス（読み取り）

メンバー（読み取り）

メンバー（書き込み）

オーディエンス（書き込み）

セグメントとタグ

マージフィールド

興味カテゴリとグループ

Webhook

自動化とカスタマージャーニー

Mailchimp は Customer Journeys の公開読み取り API を提供していません（上記のトリガーエンドポイントのみです）。search_automation_campaigns、get_member_journey_events、get_automation_summary ツールは、推奨される回避策を提供します。ジャーニーのグラフ自体は非公開のままですが、自動化またはジャーニーから配信されたすべてのキャンペーンを表示できます。

テンプレート

ランディングページ

ファイルマネージャー

アンケート

登録フォーム

Eコマース

Eコマースのカート

Eコマースのプロモーションルールとコード

バッチ操作

認証済みドメイン

接続済みサイトとアカウント

フォルダー

キャンペーンの追加機能（チェックリスト、共同作業、RSS）

オーディエンスの分析情報と到達性

メンバー（コンプライアンスと高度な機能）

オートメーションメール（個別メールの制御）

レポート（その他）

Eコマース（書き込み）

プロンプトの例

接続すると、MCP クライアントに次のようなリクエストを依頼できます。

• 「過去3か月に送信したキャンペーンをすべて表示して」
• 「直近のニュースレターの開封率とクリック率は？」
• 「今年、購読者は何人増えた？」
• 「キャンペーン X で最もクリックされたリンクは？」
• 「購読者 [email protected] を検索して」
• 「直近のキャンペーンを開封したすべてのメンバーにタグ 'VIP' を追加して」
• 「メインのオーディエンス向けに、件名 'March Update' のキャンペーンの下書きを作成して」
• 「VIP セグメントだけを対象にキャンペーンを作成して」
• 「キャンペーンの下書きのテストメールを [email protected] に送信して」
• 「メインのオーディエンスのすべてのマージフィールドを一覧表示して」
• 「選択肢が Tech、Finance、Healthcare の 'Industry' というドロップダウン式マージフィールドを作成して」
• 「FNAME が John のメンバーからなる動的セグメントを作成して」
• 「この CSV データから50人のメンバーを一括購読させて」
• 「新しい購読者が登録したときにアプリに通知する Webhook を設定して」
• 「[email protected] をリストから購読解除して」
• 「直近のキャンペーンのドメイン別パフォーマンスの内訳を表示して」
• 「ニュースレターを開封した人が世界のどこにいたか、地域別の内訳を表示して」
• 「件名を2種類用意した A/B テストキャンペーンを作成し、24時間後の開封数で勝者を決めて」
• 「直近のキャンペーンを改善するために、Mailchimp はどんなアドバイスをしていますか？」
• 「ウェルカムオートメーションを一時停止して」
• 「今月、Shopify ストアで発生した注文をすべて一覧表示して」

ワークフローのレシピ

ツールを最初から最後まで連携させる複数ステップのリクエスト：

• 週次パフォーマンスレビュー — 「先週の状況をまとめてください。月曜日以降に送信したキャンペーンを一覧にし、それぞれのレポートを取得して、クリック率順に並べ、各キャンペーンについて要点を1つ挙げてください。」 search_campaigns → get_campaign_report → get_campaign_advice の順に連携します。
• 配信到達性の監査 — 「配信の健全性を確認してください。ドメインは認証済みですか？ 最近のキャンペーンに迷惑メールの苦情はありますか？ また、直近のキャンペーンは受信者のドメイン別でどのような結果でしたか？」 list_verified_domains → get_campaign_abuse_reports → get_domain_performance の順に連携します。
• 再エンゲージメント — 「前回のニュースレターを開封しなかった人を全員見つけ、新しい件名で再送してください。」 get_campaign_report → resend_to_non_openers の順に連携します。
• 安全な配信 — 「VIP セグメント宛てのキャンペーンをドライランし、送信チェックリストを表示してから、私の確認後に送信してください。」 MAILCHIMP_DRY_RUN=true の場合、create_campaign → get_campaign_send_checklist → send_campaign の順にプレビューします。
• 代理店（複数アカウント） — 「acme と globex の両方のアカウントについて、今月の開封率が最も高いキャンペーンを一覧にしてください。」 呼び出しごとに account="acme" / account="globex" を渡します。複数アカウントを参照してください。

コントリビューション

コントリビューションを歓迎します。開発環境のセットアップ、テスト手順、プルリクエストのガイドラインについては、CONTRIBUTING.mdを参照してください。

セキュリティ

セキュリティ上の脆弱性を発見した場合は、SECURITY.mdに記載されている責任ある開示プロセスに従ってください。

変更履歴

リリース履歴の全容については、CHANGELOG.mdを参照してください。

作者

Damien Tilman が作成 — [email protected]

ライセンス

MIT — 詳細はLICENSEを参照してください。