← Back to Skills Marketplace
byungkyu

mailchimp

by byungkyu · GitHub ↗ · v1.2.5 · MIT-0
cross-platform ✓ Security Clean
18149
Downloads
12
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install mailchimp
Description
Mailchimp Marketing API integration with managed OAuth. Access audiences, campaigns, templates, automations, reports, and manage subscribers. Use this skill when users want to manage email marketing, subscriber lists, or automate email campaigns. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Mailchimp connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Mailchimp action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Mailchimp examples; they add no Mailchimp capability - Mailchimp is not an event source, a trigger cannot read Mailchimp data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Usage Guidance
Install only if you are comfortable using Maton as the gateway to your Mailchimp account. Review every write, campaign send, function deploy, trigger, or destination before approving it, because these can change subscriber data, send real email, or create ongoing automation. Prefer the CLI/OAuth flow over raw API keys, and delete unused connections, functions, triggers, and destinations when finished.
Capability Assessment
ℹ Credentials
Bash/network/OAuth access is proportionate for a Mailchimp API gateway skill, and the raw HTTP API-key path is documented as a fallback only when the CLI cannot be used.
ℹ Install Mechanism
Installation uses a pinned Maton CLI via npm or Homebrew and requires network access plus a Maton account; the artifact itself contains Markdown documentation only and no executable files.
✓ Instruction Scope
The instructions default to read/list calls, require explicit approval for connection creation and all writes, and place additional approval/scoping requirements around functions, triggers, destinations, and local --exec handling.
ℹ Persistence & Privilege
OAuth refresh tokens are stored in the OS credential store, and hosted functions/triggers/destinations can persist, but these behaviors are disclosed with approval, least-privilege, cleanup, and credential-handling guidance.
ℹ Purpose & Capability
The skill's Mailchimp API access, subscriber management, campaign operations, reports, hosted functions, and trigger automation are coherent with its stated email-marketing purpose; high-impact actions such as sending campaigns are explicitly called out.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mailchimp
  3. After installation, invoke the skill by name or use /mailchimp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.5
Simplify the login instructions to the code flow (maton login prints a link; finish with maton login --code <CODE>), drop the API Key subsection, and pin the Maton CLI install to 0.4.0.
v1.2.4
Switch the login instructions to the device flow (maton login prints a link and a user code; the --oauth flag is gone) and pin the Maton CLI install to 0.3.5.
v1.2.3
Pin the Maton CLI install to 0.3.4, the current release.
v1.2.2
Add this skill's own trigger policy to the shared Triggers section: the only destination it sets up is its own hosted function inside the platform, it does not forward events to third-party hosts, and it does not use event watch --exec; each trigger reference now also says this skill configures no trigger from that source on its own.
v1.2.1
Bring the skill to the current api-gateway baseline and tell the connection-to-function-to-trigger story: the shared Functions and Triggers sections open with an example for this app (a hosted function that performs one action for it through the Maton SDK, and the trigger that runs it - its own event source where it has one, otherwise a time schedule), the description says these constructs turn the connection into automation and add no capability of their own, the passthrough is described by its enforced boundary, CLI and SDK installs are pinned to 0.3.1, absolute API URLs are placeholders, and multipart uploads use mktemp.
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.4
- Updated all API endpoint references to use https://api.maton.ai instead of previous base URLs. - Updated connection management instructions and endpoints to match the new https://api.maton.ai base URL. - Added a security section emphasizing that all write operations require explicit user approval. - Clarified instructions for specifying a connection when multiple Mailchimp accounts are linked. - Removed the LICENSE.txt file.
v1.0.3
- Added clawdbot metadata with emoji and clarified required environment variable in SKILL.md. - No code or functional changes; documentation metadata update only.
v1.0.2
No changes detected in this release.
v1.0.1
- Added reference to the alternative api-gateway skill for third-party app integrations in the description. - Updated all code samples to use cross-platform Python CLI scripts instead of curl or Python requests. - No changes to the core API, endpoints, or overall functionality.
v1.0.0
Mailchimp skill v1.0.0 — Initial Release - Provides integration with the Mailchimp Marketing API via managed OAuth. - Allows access to and management of Mailchimp audiences (lists), campaigns, templates, automations, reports, and subscribers. - Includes detailed connection management, with support for multiple Mailchimp OAuth connections. - Offers comprehensive API reference and usage examples for managing subscriber lists and automating email campaigns. - Requires a valid Maton API key and network access for operation.
Metadata
Slug mailchimp
Version 1.2.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 12
Frequently Asked Questions

What is mailchimp?

Mailchimp Marketing API integration with managed OAuth. Access audiences, campaigns, templates, automations, reports, and manage subscribers. Use this skill when users want to manage email marketing, subscriber lists, or automate email campaigns. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a Mailchimp connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a Mailchimp action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with Mailchimp examples; they add no Mailchimp capability - Mailchimp is not an event source, a trigger cannot read Mailchimp data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe). It is an AI Agent Skill for Claude Code / OpenClaw, with 18149 downloads so far.

How do I install mailchimp?

Run "/install mailchimp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is mailchimp free?

Yes, mailchimp is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does mailchimp support?

mailchimp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created mailchimp?

It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.5.

💬 Comments