MCP Server

Active

Apache-2.0

io.github.cyanheads/mailchimp-mcp-server MCP Server

Name: io.github.cyanheads/mailchimp-mcp-server MCP Server
Author: io.github.cyanheads

io.github.cyanheads/mailchimp-mcp-server

Repository Registry

What is the io.github.cyanheads/mailchimp-mcp-server MCP server?

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

How to install io.github.cyanheads/mailchimp-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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').
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'.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<YOUR_MAILCHIMP_API_KEY>",
        "MAILCHIMP_BASE_URL": "<YOUR_MAILCHIMP_BASE_URL>",
        "MAILCHIMP_TIMEOUT_MS": "<YOUR_MAILCHIMP_TIMEOUT_MS>",
        "MAILCHIMP_MAX_RETRIES": "<YOUR_MAILCHIMP_MAX_RETRIES>",
        "MAILCHIMP_CONCURRENCY_LIMIT": "<YOUR_MAILCHIMP_CONCURRENCY_LIMIT>",
        "MAILCHIMP_ASSETS_DIR": "<YOUR_MAILCHIMP_ASSETS_DIR>",
        "MAILCHIMP_TEMPLATES_DIR": "<YOUR_MAILCHIMP_TEMPLATES_DIR>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<YOUR_MAILCHIMP_API_KEY>",
        "MAILCHIMP_BASE_URL": "<YOUR_MAILCHIMP_BASE_URL>",
        "MAILCHIMP_TIMEOUT_MS": "<YOUR_MAILCHIMP_TIMEOUT_MS>",
        "MAILCHIMP_MAX_RETRIES": "<YOUR_MAILCHIMP_MAX_RETRIES>",
        "MAILCHIMP_CONCURRENCY_LIMIT": "<YOUR_MAILCHIMP_CONCURRENCY_LIMIT>",
        "MAILCHIMP_ASSETS_DIR": "<YOUR_MAILCHIMP_ASSETS_DIR>",
        "MAILCHIMP_TEMPLATES_DIR": "<YOUR_MAILCHIMP_TEMPLATES_DIR>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailchimp-mcp-server": {
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<YOUR_MAILCHIMP_API_KEY>",
        "MAILCHIMP_BASE_URL": "<YOUR_MAILCHIMP_BASE_URL>",
        "MAILCHIMP_TIMEOUT_MS": "<YOUR_MAILCHIMP_TIMEOUT_MS>",
        "MAILCHIMP_MAX_RETRIES": "<YOUR_MAILCHIMP_MAX_RETRIES>",
        "MAILCHIMP_CONCURRENCY_LIMIT": "<YOUR_MAILCHIMP_CONCURRENCY_LIMIT>",
        "MAILCHIMP_ASSETS_DIR": "<YOUR_MAILCHIMP_ASSETS_DIR>",
        "MAILCHIMP_TEMPLATES_DIR": "<YOUR_MAILCHIMP_TEMPLATES_DIR>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mailchimp-mcp-server": {
      "type": "stdio",
      "command": "bun",
      "args": [
        "-y",
        "@cyanheads/mailchimp-mcp-server",
        "run",
        "start:stdio"
      ],
      "env": {
        "MAILCHIMP_API_KEY": "<YOUR_MAILCHIMP_API_KEY>",
        "MAILCHIMP_BASE_URL": "<YOUR_MAILCHIMP_BASE_URL>",
        "MAILCHIMP_TIMEOUT_MS": "<YOUR_MAILCHIMP_TIMEOUT_MS>",
        "MAILCHIMP_MAX_RETRIES": "<YOUR_MAILCHIMP_MAX_RETRIES>",
        "MAILCHIMP_CONCURRENCY_LIMIT": "<YOUR_MAILCHIMP_CONCURRENCY_LIMIT>",
        "MAILCHIMP_ASSETS_DIR": "<YOUR_MAILCHIMP_ASSETS_DIR>",
        "MAILCHIMP_TEMPLATES_DIR": "<YOUR_MAILCHIMP_TEMPLATES_DIR>",
        "MCP_LOG_LEVEL": "<YOUR_MCP_LOG_LEVEL>",
        "MCP_HTTP_HOST": "<YOUR_MCP_HTTP_HOST>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_HTTP_ENDPOINT_PATH": "<YOUR_MCP_HTTP_ENDPOINT_PATH>",
        "MCP_AUTH_MODE": "<YOUR_MCP_AUTH_MODE>"
      }
    }
  }
}

Claude Code

claude mcp add mailchimp-mcp-server --env MAILCHIMP_API_KEY=<YOUR_MAILCHIMP_API_KEY> --env MAILCHIMP_BASE_URL=<YOUR_MAILCHIMP_BASE_URL> --env MAILCHIMP_TIMEOUT_MS=<YOUR_MAILCHIMP_TIMEOUT_MS> --env MAILCHIMP_MAX_RETRIES=<YOUR_MAILCHIMP_MAX_RETRIES> --env MAILCHIMP_CONCURRENCY_LIMIT=<YOUR_MAILCHIMP_CONCURRENCY_LIMIT> --env MAILCHIMP_ASSETS_DIR=<YOUR_MAILCHIMP_ASSETS_DIR> --env MAILCHIMP_TEMPLATES_DIR=<YOUR_MAILCHIMP_TEMPLATES_DIR> --env MCP_LOG_LEVEL=<YOUR_MCP_LOG_LEVEL> --env MCP_HTTP_HOST=<YOUR_MCP_HTTP_HOST> --env MCP_HTTP_PORT=<YOUR_MCP_HTTP_PORT> --env MCP_HTTP_ENDPOINT_PATH=<YOUR_MCP_HTTP_ENDPOINT_PATH> --env MCP_AUTH_MODE=<YOUR_MCP_AUTH_MODE> -- bun -y @cyanheads/mailchimp-mcp-server run start:stdio

Related MCP servers

io.github.cyanheads/obsidian-mcp-server

Active

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP.

611

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/git-mcp-server

Maintained

Comprehensive Git MCP server with 28 tools for clone, commit, branching, merging, and advanced workflows.

226

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-core

Active

Agent-native TypeScript framework for building MCP servers with declarative definitions.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/mcp-ts-template

Active

TypeScript template for building MCP servers with declarative tooling, observability, and auth.

145

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/pubmed-mcp-server

Active

Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.

116

TypeScript

Apache-2.0

View repository →

io.github.cyanheads/clinicaltrialsgov-mcp-server

Active

Search ClinicalTrials.gov — find studies, retrieve results, match patients to eligible trials.

TypeScript

Apache-2.0

View repository →