← Index

io.github.cyanheads/mailchimp-mcp-server

io.github.cyanheads/mailchimp-mcp-server·v0.3.2·Other
Quality Score
80
/100

Mailchimp via MCP: draft, test, and send campaigns; manage audiences and subscribers; pull reports.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<mailchimp_api_key>",
        "MAILCHIMP_BASE_URL": "<mailchimp_base_url>",
        "MAILCHIMP_TIMEOUT_MS": "60000",
        "MAILCHIMP_MAX_RETRIES": "3",
        "MAILCHIMP_CONCURRENCY_LIMIT": "4",
        "MAILCHIMP_ASSETS_DIR": "<mailchimp_assets_dir>",
        "MAILCHIMP_TEMPLATES_DIR": "<mailchimp_templates_dir>",
        "MCP_LOG_LEVEL": "info",
        "MCP_HTTP_HOST": "127.0.0.1",
        "MCP_HTTP_PORT": "3010",
        "MCP_HTTP_ENDPOINT_PATH": "/mcp",
        "MCP_AUTH_MODE": "none"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<mailchimp_api_key>",
        "MAILCHIMP_BASE_URL": "<mailchimp_base_url>",
        "MAILCHIMP_TIMEOUT_MS": "60000",
        "MAILCHIMP_MAX_RETRIES": "3",
        "MAILCHIMP_CONCURRENCY_LIMIT": "4",
        "MAILCHIMP_ASSETS_DIR": "<mailchimp_assets_dir>",
        "MAILCHIMP_TEMPLATES_DIR": "<mailchimp_templates_dir>",
        "MCP_LOG_LEVEL": "info",
        "MCP_HTTP_HOST": "127.0.0.1",
        "MCP_HTTP_PORT": "3010",
        "MCP_HTTP_ENDPOINT_PATH": "/mcp",
        "MCP_AUTH_MODE": "none"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @cyanheads/mailchimp-mcp-server
§02  Environment variables
MAILCHIMP_API_KEY
required

Mailchimp Marketing API key, including the '-dc' data-center suffix (e.g. 'abc...-us22'). Generate at Mailchimp → Account → Extras → API keys.

MAILCHIMP_BASE_URL

Override the API base URL (for mock servers or testing). Defaults to 'https://{dc}.api.mailchimp.com/3.0' derived from the API key suffix.

MAILCHIMP_TIMEOUT_MS

Per-request timeout in milliseconds.

MAILCHIMP_MAX_RETRIES

Max retry attempts for transient upstream failures (0-10).

MAILCHIMP_CONCURRENCY_LIMIT

Max in-flight upstream requests per workflow tool (1-10).

MAILCHIMP_ASSETS_DIR

Absolute path to a local assets directory. When set (Node-only — Workers ignored), enables the `mailchimp_assets` tool and auto-uploads `@assets/<path>` references in campaign HTML to Mailchimp File Manager at send time. Cache at <dir>/.mailchimp-cache.json.

MAILCHIMP_TEMPLATES_DIR

Absolute path to a local templates directory. When set (Node-only), enables the `mailchimp_local_templates` tool and support for `content.localTemplate` on campaign tools. Templates are `.eta` files with optional `<name>.meta.yaml` sidecars. Canonical write path on free-tier Mailchimp.

MCP_LOG_LEVEL

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MAILCHIMP_API_KEY
required

Mailchimp Marketing API key, including the '-dc' data-center suffix (e.g. 'abc...-us22'). Generate at Mailchimp → Account → Extras → API keys.

MAILCHIMP_BASE_URL

Override the API base URL (for mock servers or testing). Defaults to 'https://{dc}.api.mailchimp.com/3.0' derived from the API key suffix.

MAILCHIMP_TIMEOUT_MS

Per-request timeout in milliseconds.

MAILCHIMP_MAX_RETRIES

Max retry attempts for transient upstream failures (0-10).

MAILCHIMP_CONCURRENCY_LIMIT

Max in-flight upstream requests per workflow tool (1-10).

MCP_HTTP_HOST

The hostname for the HTTP server.

MCP_HTTP_PORT

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH

The endpoint path for the MCP server.

MCP_AUTH_MODE

Authentication mode to use: 'none', 'jwt', or 'oauth'.

MCP_LOG_LEVEL

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Other