Connect Mailchimp to Claude Code
Read Mailchimp audiences, members, campaigns, reports, segments, tags and templates. Add Toolspoke to Claude Code once and it can use 11 Mailchimp actions. Your Mailchimp credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Mailchimp and connect it
Add Mailchimp to a project in your Toolspoke workspace.
API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API key, with a username in front of it
- Paste it in exactly that form: any word at all, then a colon, then your API key. Mailchimp reads this as HTTP Basic and ignores the username, its own documentation uses the literal word `anystring` there, but Basic authentication has no shape without one, so the colon and something before it must be present. Create the key in Mailchimp → Account & billing → Extras → API keys.
- Data centre
- The suffix after the last dash of your API key: a key ending -us14 belongs to us14. It is also the first part of the hostname when you are signed in to Mailchimp (https://us14.admin.mailchimp.com). Every account's API lives on its own data centre, and a key sent to the wrong one is rejected as if it were invalid.
Choose what Claude Code may do
All 11 actions start on. Switch off the one action that changes something in Mailchimp, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Mailchimp actions that only read, so they are safe to try first.
- List the account's audiences, what the Mailchimp UI calls audiences and the API calls lists
- List the contacts in an audience
- List campaigns with their type, status, audience, subject line and send time
- Fetch one campaign by ID, with its settings, subject line, sender, audience and recipient count
What Claude Code can do in Mailchimp
10 actions read and one writes.
Reads
List audiences
List the account's audiences, what the Mailchimp UI calls audiences and the API calls lists. Returns each audience's ID, name, contact details, default sender and subscriber statistics. The list_id here is what every member, segment and tag action needs.
Get audience
Fetch one audience by ID, with its sender defaults, permission reminder, mandatory physical address and subscriber counts. Read stats.member_count and stats.unsubscribe_count from here rather than counting members.
List members
List the contacts in an audience. This returns real people, email addresses, names, merge fields, signup IP addresses and location, so filter rather than paging the whole audience. Filter by status to find who is subscribed, unsubscribed, cleaned (bounced) or still pending confirmation, and by since_last_changed to see recent movement.
Get member
Fetch one contact from an audience, with their status, merge fields, tags, engagement rating and signup details. subscriber_hash is the MD5 of the lowercased email address, and Mailchimp also accepts the plain email address or a contact_id in its place.
List campaigns
List campaigns with their type, status, audience, subject line and send time. Filter by status to separate what has gone out (sent) from what is still a draft (save) or waiting (schedule), and by since_send_time to find recent sends worth reporting on.
Get campaign
Fetch one campaign by ID, with its settings, subject line, sender, audience and recipient count. Call get_campaign_report for how it actually performed.
Get campaign report
The reporting action. Fetch the performance of one sent campaign: emails sent, opens, clicks, bounces, unsubscribes, abuse reports, ecommerce revenue, and industry averages to compare against. Only works for a campaign that has actually been sent. Returns aggregate counts, not the individual people behind them.
List segments
List an audience's segments, with each one's type and how many contacts it currently matches. saved segments are rule-driven and re-evaluated; static segments are fixed lists, which is also how Mailchimp stores tags internally. Returns definitions and counts, not the contacts in them.
List tags
List the tags defined on an audience, as ID and name pairs. Pass name to keep only tags starting with that prefix; omit it for all of them. This endpoint has no paging of its own, so a very heavily tagged audience returns everything in one response.
List templates
List the email templates available to the account, the ones your team saved (user), Mailchimp's own starting points (base) and its gallery designs (gallery). Returns names, IDs and edit dates, not the HTML.
Writes
Add or update member
Add a contact to an audience, or update one already on it. Mailchimp keys on subscriber_hash, so calling this twice with the same address updates rather than duplicates. status_if_new is what a brand new contact gets and is ignored for one that already exists; status changes an existing contact. Use "pending" for status_if_new to send the double opt-in confirmation, "subscribed" to add them outright, only do that where you have a record of consent. Setting status to "unsubscribed" removes them from every future send.
Mailchimp in Claude Code: questions
Does Claude Code see my Mailchimp credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Mailchimp?
Yes. Each of the 11 actions can be switched off for a project. Turn off the one that changes something and Claude Code can only read.
Will 11 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Mailchimp action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Mailchimp call does not run in a sandbox, so it bills nothing.
Mailchimp in your other apps
Try Mailchimp in Claude Code
Free to start, and tool calls cost nothing on any plan.