mtl-mailchimp-mcp

Model Context Protocol (MCP) server for Mailchimp.

Copy or create newsletter campaigns, push HTML content, and send test emails — all from Claude Code or any MCP-compatible client.

Draft + test only. This server can list, copy, and create draft campaigns and send test emails to seed addresses. It deliberately exposes no send/schedule tool — you review the draft and hit Send in the Mailchimp UI. No accidental blasts from the CLI.

Tools

Related MCP server: mailchimp-mcp

Setup

1. Get a Mailchimp API key

Mailchimp → Account → Extras → API keys. The key ends in a data-center suffix like -us19, which the server uses to find the right API host.

2. Configure

cp .env.example .env
# edit .env and paste your MAILCHIMP_API_KEY
poetry install

3. Register with Claude Code

{
  "mcpServers": {
    "mtl-mailchimp": {
      "command": "poetry",
      "args": ["run", "python", "-m", "mtl_mailchimp_mcp"],
      "cwd": "/absolute/path/to/mtl-mailchimp-mcp"
    }
  }
}

Typical flow: reuse last month's newsletter

1. mailchimp_list_campaigns — find the previous issue

2. mailchimp_replicate_campaign <id> — fresh draft

3. mailchimp_set_content_from_file <new_id> /path/to/newsletter.html — push new HTML

4. mailchimp_update_settings <new_id> subject="..." preview_text="..."

5. mailchimp_send_test <new_id> — check your inbox

6. Review in Mailchimp and send from the UI

Note on images: Mailchimp does not rehost images. Use absolute URLs in your HTML (e.g. https://yourdomain.com/img/...) so they render in the inbox.

Security

• Your API key lives only in .env (git-ignored) and is never logged.

• mailchimp_set_content_from_file is confined to MAILCHIMP_CONTENT_DIR (or your home directory) and refuses hidden paths and secret files (keys, certs, *.env).

• No send/schedule capability — see SECURITY.md.

Development

poetry install
poetry run ruff check .
poetry run ruff format --check .
poetry run pytest

Built by MusicTech Lab.