productivity
Mailchimp MCP Integration for Codex
Connect Mailchimp to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
18 functions 9 read 9 write API key auth
Connect Mailchimp to Codex
Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.
Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with
--write=deny so Codex can inspect read-capable tools without receiving write access by default.
Mailchimp MCP Config for Codex
Keep write access denied or ask-based unless the workspace is trusted.
{
"mcpServers": {
"kosmokrator-mailchimp": {
"type": "stdio",
"command": "kosmo",
"args": [
"mcp:serve",
"--integration=mailchimp",
"--write=deny"
]
}
}
}Run the Gateway Manually
kosmokrator mcp:serve --integration=mailchimp --write=denyWhy Use KosmoKrator Here
Scoped tools
Expose only Mailchimp instead of a broad multi-service tool list.
Local credentials
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Write policy
Start read-only, then opt into ask or allow for trusted workspaces.
Mailchimp Tools Visible to Codex
Codex sees stable MCP tool names generated from the Mailchimp integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
integration__mailchimp__mailchimp_list_audiences | mailchimp.mailchimp_list_audiences | Read | 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. |
integration__mailchimp__mailchimp_get_audience | mailchimp.mailchimp_get_audience | Read | Get full details for a single Mailchimp audience (list) by its ID. Returns the audience name, contact information, subscription stats, and default settings. |
integration__mailchimp__mailchimp_create_audience | mailchimp.mailchimp_create_audience | Write | 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. |
integration__mailchimp__mailchimp_add_subscriber | mailchimp.mailchimp_add_subscriber | Write | 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. |
integration__mailchimp__mailchimp_get_subscriber | mailchimp.mailchimp_get_subscriber | Read | Retrieve a subscriber's details from a Mailchimp audience by their email address. Returns the subscriber's status, merge fields, tags, and activity timestamps. |
integration__mailchimp__mailchimp_update_subscriber | mailchimp.mailchimp_update_subscriber | Write | 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. |
integration__mailchimp__mailchimp_search_subscribers | mailchimp.mailchimp_search_subscribers | Read | 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. |
integration__mailchimp__mailchimp_remove_subscriber | mailchimp.mailchimp_remove_subscriber | Write | Remove (archive) a subscriber from a Mailchimp audience by their email address. This archives the member; it does not permanently delete it. |
integration__mailchimp__mailchimp_create_campaign | mailchimp.mailchimp_create_campaign | Write | 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. |
integration__mailchimp__mailchimp_get_campaign | mailchimp.mailchimp_get_campaign | Read | Get details for a single Mailchimp campaign by its ID. Returns the campaign type, status, settings, recipient list, and send times. |
integration__mailchimp__mailchimp_update_campaign | mailchimp.mailchimp_update_campaign | Write | 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. |
integration__mailchimp__mailchimp_send_campaign | mailchimp.mailchimp_send_campaign | Write | 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. |
integration__mailchimp__mailchimp_list_campaigns | mailchimp.mailchimp_list_campaigns | Read | 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. |
integration__mailchimp__mailchimp_tag_subscriber | mailchimp.mailchimp_tag_subscriber | Write | 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). |
integration__mailchimp__mailchimp_list_segments | mailchimp.mailchimp_list_segments | Read | List all segments (static and dynamic) for a Mailchimp audience. Returns each segment's ID, name, type, and member count. |
integration__mailchimp__mailchimp_add_to_segment | mailchimp.mailchimp_add_to_segment | Write | 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. |
integration__mailchimp__mailchimp_get_campaign_report | mailchimp.mailchimp_get_campaign_report | Read | Get a detailed report for a sent Mailchimp campaign. Returns send stats (emails sent, bounces), open rates, click rates, and industry benchmarks. |
integration__mailchimp__mailchimp_get_current_user | mailchimp.mailchimp_get_current_user | Read | 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. |