mailchimp
Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.
- License 许可
- MIT
- 最近更新
- 2026-10-27
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- mailchimp
- license
- MIT
- version
- 1.0.0
- metadata
- { "tags": "mailchimp,email,campaigns,marketing,audiences", "author": "Matimo", "apply-to": "mailchimp-create-campaign mailchimp-send-campaign mailchimp-get-campaign mailchimp-list-campaigns mailchimp-add-member mailchimp-list-members mailchimp-get-member", "category": "Marketing", "difficulty": "intermediate" }
- description
- Complete guide to all Mailchimp tools — campaigns, audiences, lists, templates, segments, and email marketing.
03 SKILL.md 正文
Mailchimp
Complete guide to using Matimo's Mailchimp tools for campaign management, audience operations, and email marketing.
All Available Tools
| Tool | Purpose | Category |
|---|---|---|
mailchimp-create-campaign |
Create a new campaign | Campaigns |
mailchimp-send-campaign |
Send or schedule a campaign | Campaigns |
mailchimp-get-campaign |
Get campaign details and stats | Campaigns |
mailchimp-list-campaigns |
List campaigns with filters | Campaigns |
mailchimp-add-member |
Add a subscriber to an audience | Audiences |
mailchimp-list-members |
List subscribers in an audience | Audiences |
mailchimp-get-member |
Get subscriber details | Audiences |
Authentication
Requires MAILCHIMP_API_KEY (format: key-dc, where dc is the data center, e.g., abc123-us21).
Campaigns
Creating Campaigns
Use mailchimp-create-campaign with:
type—regular,plaintext,absplit, orrssrecipients—{ "list_id": "..." }(required audience)settings—subject_line,from_name,reply_to,title
{
"type": "regular",
"recipients": { "list_id": "abc123" },
"settings": {
"subject_line": "Weekly Newsletter",
"from_name": "Acme Team",
"reply_to": "team@acme.com"
}
}
Sending Campaigns
Use mailchimp-send-campaign with campaign_id. Ensure campaign has content and recipients before sending.
Pre-send checklist:
- Campaign has content (template or HTML)
- Recipients/audience set
- Subject line and from address configured
- Test email sent
Campaign Stats
Use mailchimp-get-campaign to retrieve delivery stats: emails_sent, opens, clicks, bounces, unsubscribes.
Audiences (Lists)
Adding Members
Use mailchimp-add-member with:
list_id(required) — the audience IDemail_address(required) — subscriber emailstatus—subscribed,unsubscribed,cleaned,pendingmerge_fields—{ "FNAME": "Alice", "LNAME": "Smith" }
Best practices:
- Always use
pendingstatus for double opt-in compliance - Set merge fields for personalization
- Check for existing subscribers before adding
Listing Members
Use mailchimp-list-members with list_id and optional status, count, offset for pagination.
Getting Member Details
Use mailchimp-get-member with list_id and subscriber_hash (MD5 of lowercase email) or email_address.
Common Workflows
Newsletter Campaign
- Add new subscribers:
mailchimp-add-memberwithstatus: "pending" - Create campaign:
mailchimp-create-campaign - Send campaign:
mailchimp-send-campaign - Check results:
mailchimp-get-campaignfor stats
Audience Growth Tracking
- List members:
mailchimp-list-memberswith different statuses - Monitor subscriber counts over time
- Review bounce and unsubscribe rates
Common Errors
| Error | Cause | Fix |
|---|---|---|
401 API Key Invalid |
Wrong API key or data center | Check key format key-dc |
400 Member Exists |
Email already in audience | Use update instead of add |
400 Campaign Not Ready |
Missing content or recipients | Complete all required fields |
429 Too Many Requests |
Rate limit (10 concurrent connections) | Implement backoff |
404 Resource Not Found |
Invalid list_id or campaign_id | Verify IDs |
04 同仓库更多 Skills
twilio
Complete guide to all Twilio tools — text, media, delivery tracking, E.164 formatting, and message management.
slack
Complete guide to all Slack tools — messaging, channels, users, search, files, reactions, and threads.
postgres
Complete guide to all PostgreSQL tools — parameterized queries, schema navigation, data retrieval, and safe database interaction patterns.
notion
Complete guide to all Notion tools — databases, pages, blocks, queries, and content management.
hubspot
Complete guide to all HubSpot CRM tools — contacts, companies, deals, tickets, products, line items, pipelines, and entity management.
gmail
Complete guide to all Gmail tools — inbox management, email sending, labels, search, and threads.