Skip to content
MCP server

Mailchimp MCP Server

Mailchimp via MCP: draft, test, and send campaigns; manage audiences and subscribers…

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.6.0
Listing updated
4 days ago

About Mailchimp MCP Server

Mailchimp MCP Server is an open-source MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

claude mcp add mailchimp-mcp-server --env MAILCHIMP_API_KEY='<MAILCHIMP_API_KEY>' -- npx -y @cyanheads/mailchimp-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<MAILCHIMP_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<MAILCHIMP_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mailchimp-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<MAILCHIMP_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<MAILCHIMP_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<MAILCHIMP_API_KEY>"
      }
    }
  }
}

Configuration

  • MAILCHIMP_API_KEYMailchimp Marketing API key, including the '-dc' data-center suffix (e.g. 'abc...-us22'). Generate at Mailchimp → Account → Extras → API keys.Required
  • MAILCHIMP_BASE_URLOverride 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_MSPer-request timeout in milliseconds.
  • MAILCHIMP_MAX_RETRIESMax retry attempts for transient upstream failures (0-10).
  • MAILCHIMP_CONCURRENCY_LIMITMax in-flight upstream requests across this process (1-10).
  • MAILCHIMP_ASSETS_DIRAbsolute 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_DIRAbsolute 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 YAML frontmatter; legacy `<name>.meta.yaml` sidecars are read when frontmatter is absent. Canonical write path on free-tier Mailchimp.
  • MCP_LOG_LEVELMinimum log level for output: debug, info, notice, warning, or error.
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • MAILCHIMP_API_KEYMailchimp Marketing API key, including the '-dc' data-center suffix (e.g. 'abc...-us22'). Generate at Mailchimp → Account → Extras → API keys.Required
  • MAILCHIMP_BASE_URLOverride 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_MSPer-request timeout in milliseconds.
  • MAILCHIMP_MAX_RETRIESMax retry attempts for transient upstream failures (0-10).
  • MAILCHIMP_CONCURRENCY_LIMITMax in-flight upstream requests across this process (1-10).
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELMinimum log level for output: debug, info, notice, warning, or error.

Pricing

Open source

Mailchimp MCP Server FAQ

Is Mailchimp MCP Server free?

Yes. Mailchimp MCP Server is open source, so you can use and self-host it for free.

How do I add Mailchimp MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mailchimp-mcp-server --env MAILCHIMP_API_KEY='<MAILCHIMP_API_KEY>' -- npx -y @cyanheads/mailchimp-mcp-server

What are the best alternatives to Mailchimp MCP Server?

The closest alternatives to Mailchimp MCP Server are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and PostBaton.

Alternatives to Mailchimp MCP Server

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO