Automate Klaviyo tasks via Rube MCP (Composio): manage email/SMS campaigns, inspect campaign messages, track tags, and monitor send jobs. Always search tools first for current schemas.
npxskills add sickn33/antigravity-awesome-skills--skill klaviyo-automationLoading…
Automate Klaviyo email and SMS marketing operations through Composio's Klaviyo toolkit via Rube MCP.
RUBE_MANAGE_CONNECTIONS with toolkit klaviyoRUBE_SEARCH_TOOLS first to get current tool schemasGet Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
RUBE_SEARCH_TOOLS respondsRUBE_MANAGE_CONNECTIONS with toolkit klaviyoWhen to use: User wants to browse, search, or filter marketing campaigns
Tool sequence:
KLAVIYO_GET_CAMPAIGNS - List campaigns with channel and status filters [Required]Key parameters:
channel: Campaign channel - 'email' or 'sms' (required by Klaviyo API)filter: Additional filter string (e.g., equals(status,"draft"))sort: Sort field with optional - prefix for descending (e.g., '-created_at', 'name')page_cursor: Pagination cursor for next pageinclude_archived: Include archived campaigns (default: false)Pitfalls:
channel is required; omitting it can produce incomplete or unexpected resultspage_cursor until exhausted to get all campaignsfilter (e.g., equals(status,"draft")) can return mixed statuses; always validate data[].attributes.status client-sideresponse.data.data with status at data[].attributes.statusWhen to use: User wants detailed information about a specific campaign
Tool sequence:
KLAVIYO_GET_CAMPAIGNS - Find campaign to get its ID [Prerequisite]KLAVIYO_GET_CAMPAIGN - Retrieve full campaign details [Required]Key parameters:
campaign_id: Campaign ID string (e.g., '01GDDKASAP8TKDDA2GRZDSVP4H')include_messages: Include campaign messages in responseinclude_tags: Include tags in responsePitfalls:
include_messages and include_tags add related data to the response via Klaviyo's include mechanismWhen to use: User wants to view the email/SMS content of a campaign
Tool sequence:
KLAVIYO_GET_CAMPAIGN - Find campaign and its message IDs [Prerequisite]KLAVIYO_GET_CAMPAIGN_MESSAGE - Get message content details [Required]Key parameters:
id: Message ID stringfields__campaign__message: Sparse fieldset for message attributes (e.g., 'content.subject', 'content.from_email', 'content.body')fields__campaign: Sparse fieldset for campaign attributesfields__template: Sparse fieldset for template attributesinclude: Related resources to include ('campaign', 'template')Pitfalls:
When to use: User wants to view tags associated with campaigns for organization
Tool sequence:
KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS - Get tag IDs for a campaign [Required]Key parameters:
id: Campaign ID stringPitfalls:
When to use: User wants to check the status of a campaign send operation
Tool sequence:
KLAVIYO_GET_CAMPAIGN_SEND_JOB - Check send job status [Required]Key parameters:
id: Send job IDPitfalls:
1. Call KLAVIYO_GET_CAMPAIGNS with channel='email'
2. Paginate through all results via page_cursor
3. Filter by status client-side for accuracy
4. Extract campaign IDs for detailed inspection
Klaviyo supports sparse fieldsets to reduce response size:
fields__campaign__message=['content.subject', 'content.from_email', 'send_times']
fields__campaign=['name', 'status', 'send_time']
fields__template=['name', 'html', 'text']
page_cursor in the pagination metadatapage_cursor in next request- equals(status,"draft") - Campaigns in draft status
- equals(name,"Newsletter") - Campaign named "Newsletter"
- greater-than(created_at,"2024-01-01T00:00:00Z") - Created after date
API Version:
Response Nesting:
response.data.data[].attributesdata[].attributes.statusRate Limits:
Status Values:
| Task | Tool Slug | Key Params |
|---|---|---|
| List campaigns | KLAVIYO_GET_CAMPAIGNS | channel, filter, sort, page_cursor |
| Get campaign details | KLAVIYO_GET_CAMPAIGN | campaign_id, include_messages, include_tags |
| Get campaign message | KLAVIYO_GET_CAMPAIGN_MESSAGE | id, fields__campaign__message |
| Get campaign tags | KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS | id |
| Get send job status | KLAVIYO_GET_CAMPAIGN_SEND_JOB | id |
This skill is applicable to execute the workflow or actions described in the overview.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).