Can I use Mailchimp as a CLI?

Yes. KosmoKrator exposes a Mailchimp CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Mailchimp through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Mailchimp tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Mailchimp credentials stored?

Mailchimp credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Mailchimp MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Mailchimp MCP, CLI, and Lua Integration for AI Agents

Mailchimp integration docs for AI agents: MCP gateway setup, Mailchimp CLI commands, Lua API reference, credentials, and function schemas.

18 functions 9 read 9 write API key auth

Submit Mailchimp feedback View package source

Mailchimp for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: mailchimp
route_slug: mailchimp
package: mailchimp
auth_strategy: api_key API key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Mailchimp CLIHeadless setup and direct function calls. Mailchimp MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Mailchimp MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Mailchimp.

Mailchimp CLI Matrix

Use these pages for direct Mailchimp CLI workflows in scripts, CI, cron, and agent wrappers.

CI Mailchimp CLI for CI. Cron Jobs Mailchimp CLI for cron jobs. Shell Scripts Mailchimp CLI for shell scripts. Headless Automation Mailchimp CLI for headless automation. Coding Agents Mailchimp CLI for coding agents.

Function Catalog

Function	Type	Parameters	Description
`mailchimp.mailchimp_list_audiences`	Read `read`	2	List all audiences (lists) in the connected Mailchimp account. Returns each audience's ID, name, subscriber count, and other metadata. Supports offset-based pagination via the count and offset parameters.
`mailchimp.mailchimp_get_audience`	Read `read`	1	Get full details for a single Mailchimp audience (list) by its ID. Returns the audience name, contact information, subscription stats, and default settings.
`mailchimp.mailchimp_create_audience`	Write `write`	5	Create a new audience (list) in Mailchimp. Requires a name, contact information, permission reminder, and campaign defaults. Returns the newly created audience with its ID.
`mailchimp.mailchimp_add_subscriber`	Write `write`	5	Add a new subscriber or update an existing one in a Mailchimp audience. Uses a PUT upsert based on the subscriber's email address (MD5 hash). Optionally set merge fields and initial tags. Returns the subscriber record with their ID and status.
`mailchimp.mailchimp_get_subscriber`	Read `read`	2	Retrieve a subscriber's details from a Mailchimp audience by their email address. Returns the subscriber's status, merge fields, tags, and activity timestamps.
`mailchimp.mailchimp_update_subscriber`	Write `write`	4	Update an existing subscriber's merge fields and/or status in a Mailchimp audience. Provide the subscriber's email address to identify the record. Returns the updated subscriber details.
`mailchimp.mailchimp_search_subscribers`	Read `read`	3	Search for subscribers by email address or name across all audiences or within a specific list. Returns matching subscriber records with their list membership and status.
`mailchimp.mailchimp_remove_subscriber`	Write `write`	2	Remove (archive) a subscriber from a Mailchimp audience by their email address. This archives the member; it does not permanently delete it.
`mailchimp.mailchimp_create_campaign`	Write `write`	6	Create a new campaign in Mailchimp. Requires a campaign type and the target list_id. Optional settings include subject line, title, from name, and reply-to address. Returns the newly created campaign with its ID and web_id.
`mailchimp.mailchimp_get_campaign`	Read `read`	1	Get details for a single Mailchimp campaign by its ID. Returns the campaign type, status, settings, recipient list, and send times.
`mailchimp.mailchimp_update_campaign`	Write `write`	2	Update a Mailchimp campaign's settings such as subject line, title, from name, or reply-to. Provide the campaign ID and a settings object with the fields to update. Returns the updated campaign details.
`mailchimp.mailchimp_send_campaign`	Write `write`	1	Send a Mailchimp campaign immediately. The campaign must already have content configured and be in a "save" or "paused" state. This action is irreversible — once sent, the campaign cannot be recalled.
`mailchimp.mailchimp_list_campaigns`	Read `read`	4	List campaigns in the Mailchimp account with offset-based pagination and optional filters. Filter by status (save, paused, schedule, sending, sent) or type (regular, plaintext, absplit, rss, variate). Returns each campaign's ID, title, status, and send time.
`mailchimp.mailchimp_tag_subscriber`	Write `write`	3	Add or remove tags on a Mailchimp subscriber. Provide an array of tags, each with a name and status ("active" to add, "inactive" to remove).
`mailchimp.mailchimp_list_segments`	Read `read`	2	List all segments (static and dynamic) for a Mailchimp audience. Returns each segment's ID, name, type, and member count.
`mailchimp.mailchimp_add_to_segment`	Write `write`	3	Add a subscriber to a Mailchimp static segment by email address. The segment must be a static (not dynamic) segment. Returns the segment membership details.
`mailchimp.mailchimp_get_campaign_report`	Read `read`	1	Get a detailed report for a sent Mailchimp campaign. Returns send stats (emails sent, bounces), open rates, click rates, and industry benchmarks.
`mailchimp.mailchimp_get_current_user`	Read `read`	0	Get the authenticated Mailchimp user's account information. Returns account name, email, total subscribers, industry stats, and plan details. Useful for verifying the connection and understanding the account scope.