Summary
Connects Claude to Klaviyo's email marketing platform through the Pipeworx gateway. You get two tools: one to list all your email lists with subscriber counts and metadata, another to pull full campaign details including subject lines, recipient lists, and performance stats. It's part of Pipeworx's broader gateway that covers 673+ data sources, so you can either connect to Klaviyo standalone or tap into the full gateway. If you're managing email campaigns in Klaviyo and want to query or analyze that data through Claude without switching contexts, this gives you direct API access through MCP's tool interface.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
27 tools
klaviyo_get_account_detailsGet the details of the account. You can view and edit your account details flow in the Klaviyo UI at https://www.klaviyo.com/settings/account1 params
Get the details of the account. You can view and edit your account details flow in the Klaviyo UI at https://www.klaviyo.com/settings/account
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_get_campaignsReturns some or all campaigns based on filters. You can view and edit a campaign in the Klaviyo UI at https://www.klaviyo.com/campaign/{CAMPAIGN_ID}/wizard. Do not use this for queries related to the status of campaigns, reporting on campaigns, or campaign performance data. Fo...6 params
Returns some or all campaigns based on filters. You can view and edit a campaign in the Klaviyo UI at https://www.klaviyo.com/campaign/{CAMPAIGN_ID}/wizard. Do not use this for queries related to the status of campaigns, reporting on campaigns, or campaign performance data. Fo...
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
channelstringWhich types of campaigns to return. To get all types of campaigns, call this tool for each channel.one of
email · sms · mobile_pushfiltersarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
campaignMessageFieldsarrayFields to return for associated campaign messages.
klaviyo_get_campaignReturns a specific campaign based on a required id. You can view and edit a campaign in the Klaviyo UI at https://www.klaviyo.com/campaign/{CAMPAIGN_ID}/wizard2 params
Returns a specific campaign based on a required id. You can view and edit a campaign in the Klaviyo UI at https://www.klaviyo.com/campaign/{CAMPAIGN_ID}/wizard
Parameters* required
idstringmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_create_campaignCreates a new draft campaign. For email campaigns, this can be used with the create_email_template tool for template creation and then assign_template_to_campaign_message to assign the template to the email campaign. You can view and edit a campaign in the Klaviyo UI at https:...2 params
Creates a new draft campaign. For email campaigns, this can be used with the create_email_template tool for template creation and then assign_template_to_campaign_message to assign the template to the email campaign. You can view and edit a campaign in the Klaviyo UI at https:...
Parameters* required
inputobjectCampaignCreateQuery
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_assign_template_to_campaign_messageAssigns an email template to a campaign message. This should be used after creating a template with the create_email_template tool and creating an email campaign.3 params
Assigns an email template to a campaign message. This should be used after creating a template with the create_email_template tool and creating an email campaign.
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otheremailTemplateIdstringThe ID of the email template to assign to the campaign message.
campaignMessageIdstringThe ID of the email campaign message to assign the template to.
klaviyo_get_flowsReturns some or all flows based on filters. You can view and edit a flow in the Klaviyo UI at https://www.klaviyo.com/flow/{FLOW_ID}/edit. Do not use this for queries related to the status of flows, reporting on flows, or flow performance data. For those use cases, use the get...5 params
Returns some or all flows based on filters. You can view and edit a flow in the Klaviyo UI at https://www.klaviyo.com/flow/{FLOW_ID}/edit. Do not use this for queries related to the status of flows, reporting on flows, or flow performance data. For those use cases, use the get...
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filtersarraypageSizeintegerNumber of results to return per page (1-100)
pageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
klaviyo_get_flowReturns a flow by ID. You can view and edit a flow in the Klaviyo UI at https://www.klaviyo.com/flow/{FLOW_ID}/edit.2 params
Returns a flow by ID. You can view and edit a flow in the Klaviyo UI at https://www.klaviyo.com/flow/{FLOW_ID}/edit.
Parameters* required
idstringmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_get_listsGet all lists in an account. To filter by tag, do not use the 'filters' parameter. Instead, call this and look for the 'tags' property in the response. You can view and edit a list in the Klaviyo UI at https://www.klaviyo.com/lists/{LIST_ID}5 params
Get all lists in an account. To filter by tag, do not use the 'filters' parameter. Instead, call this and look for the 'tags' property in the response. You can view and edit a list in the Klaviyo UI at https://www.klaviyo.com/lists/{LIST_ID}
Parameters* required
sortstringWhat to sort by.one of
created · -created · id · -id · name · -namemodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filterarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
klaviyo_get_listGet a list with the given list ID. You can view and edit a list in the Klaviyo UI at https://www.klaviyo.com/lists/{LIST_ID}3 params
Get a list with the given list ID. You can view and edit a list in the Klaviyo UI at https://www.klaviyo.com/lists/{LIST_ID}
Parameters* required
idstringmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherincludeProfileCountbooleanWhether to include the number of profiles. Only set to true if this is requested.default: false
klaviyo_get_eventsGet individual event records for a given filter such as a profile ID or metric ID. For aggregated data, prefer get_campaign_report or get_flow_report (performance metrics) or query_metric_aggregates (counts, sums, unique profiles). Only use this tool to inspect specific events...7 params
Get individual event records for a given filter such as a profile ID or metric ID. For aggregated data, prefer get_campaign_report or get_flow_report (performance metrics) or query_metric_aggregates (counts, sums, unique profiles). Only use this tool to inspect specific events...
Parameters* required
sortstringWhat to sort by.one of
datetime · -datetime · timestamp · -timestampmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filterarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
metricFieldsarrayFields to return for associated metrics.
profileFieldsarrayFields to return for associated profiles.
klaviyo_get_catalog_itemsGet all catalog items in an account. (Also known as products)6 params
Get all catalog items in an account. (Also known as products)
Parameters* required
sortstringWhat to sort by.one of
created · -createdmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filterarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
catalogVariantFieldsarrayFields to return for associated catalog variants.
klaviyo_get_email_templateGet an email template with the given data. Returns attributes including the html or amp. You can view and edit a template in the Klaviyo UI at https://www.klaviyo.com/email-editor/{TEMPLATE_ID}/edit.2 params
Get an email template with the given data. Returns attributes including the html or amp. You can view and edit a template in the Klaviyo UI at https://www.klaviyo.com/email-editor/{TEMPLATE_ID}/edit.
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othertemplateIdstringThe ID of the template return
klaviyo_create_email_templateCreate a new email template from the given HTML. Returns the ID of the template. You can view and edit a template in the Klaviyo UI at https://www.klaviyo.com/email-editor/{TEMPLATE_ID}/edit.4 params
Create a new email template from the given HTML. Returns the ID of the template. You can view and edit a template in the Klaviyo UI at https://www.klaviyo.com/email-editor/{TEMPLATE_ID}/edit.
Parameters* required
htmlstring
The complete HTML of the template. Should include <html> and <body> tags.
To include an image, first upload the image using the upload_image_from_file or upload_image_from_url tool, then use the returned image URL.
Always include an unsubscribe link. Do this by inserting the template string "{% unsubscribe 'Unsubscribe' %}". You can replace 'Unsubscribe' with custom text.
To add an editable region to the template, ensure the has_editable_regions param is true and add the following:
<td align="center" data-klaviyo-region="true" data-klaviyo-region-width-pixels="600"></td>
To add an editable text block, add the following within that region:
<div class="klaviyo-block klaviyo-text-block">Hello world!</div>
To add an editable image block, add the following within that region:
<div class="klaviyo-block klaviyo-image-block"></div>
To add a universal content block, add the following within that region, replacing block_id with the ID of the universal content block:
<div data-klaviyo-universal-block="block_id"> <div>
namestringThe name of the template
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherhasEditableRegionsbooleanWhether the template HTML contains editable regions. Should be false unless they explicitly request an editable/drag-and-drop/hybrid template.default: false
klaviyo_get_profilesGet all profiles in an account. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}6 params
Get all profiles in an account. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}
Parameters* required
sortstringWhat to sort by.one of
created · -created · email · -email · id · -idmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filtersarraypageSizeintegerNumber of results to return per page (1-100)default: 5
pageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
klaviyo_get_profileGet details of the profile with the given profile ID. Includes additional information about their subscriptions. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}2 params
Get details of the profile with the given profile ID. Includes additional information about their subscriptions. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}
Parameters* required
idstringThe profile ID to retrieve.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_create_profileCreate a new profile. Must include either email, phone_number, or external_id. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}2 params
Create a new profile. Must include either email, phone_number, or external_id. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}
Parameters* required
inputobjectProfileCreateQuery
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_update_profileUpdate the profile with the given profile ID. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}2 params
Update the profile with the given profile ID. You can view and edit a profile in the Klaviyo UI at https://www.klaviyo.com/profile/{PROFILE_ID}
Parameters* required
inputobjectProfilePartialUpdateQuery
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_get_segmentsGet all segments in an account. To filter by tag, do not use the 'filters' parameter. Instead, call this and look for the 'tags' property in the response. You can view and edit a segment in the Klaviyo UI at https://www.klaviyo.com/lists/{SEGMENT_ID}5 params
Get all segments in an account. To filter by tag, do not use the 'filters' parameter. Instead, call this and look for the 'tags' property in the response. You can view and edit a segment in the Klaviyo UI at https://www.klaviyo.com/lists/{SEGMENT_ID}
Parameters* required
sortstringWhat to sort by.one of
created · -created · id · -id · name · -namemodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filtersarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
klaviyo_get_segmentGet a segment with the given segment ID. You can view and edit a segment in the Klaviyo UI at https://www.klaviyo.com/lists/{SEGMENT_ID}3 params
Get a segment with the given segment ID. You can view and edit a segment in the Klaviyo UI at https://www.klaviyo.com/lists/{SEGMENT_ID}
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othersegmentIdstringincludeProfileCountbooleanWhether to include the number of profiles. Only set to true if this is requested.default: false
klaviyo_get_metricsGet all metrics in an account. You can view and edit a metric in the Klaviyo UI at https://www.klaviyo.com/metric/{METRIC_ID}/{METRIC_NAME}4 params
Get all metrics in an account. You can view and edit a metric in the Klaviyo UI at https://www.klaviyo.com/metric/{METRIC_ID}/{METRIC_NAME}
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfieldsarrayFields to return.
filterarraypageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
klaviyo_get_metricGet a metric with the given metric ID. You can view and edit a metric in the Klaviyo UI at https://www.klaviyo.com/metric/{METRIC_ID}/{METRIC_NAME}2 params
Get a metric with the given metric ID. You can view and edit a metric in the Klaviyo UI at https://www.klaviyo.com/metric/{METRIC_ID}/{METRIC_NAME}
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othermetricIdstringThe ID of the metric to return
klaviyo_query_metric_aggregatesQuery and aggregate event data for a specific metric, with optional grouping by dimensions such as flows, campaigns, messages, etc. IMPORTANT: This endpoint returns data based on EVENT TIME (when events occurred), NOT send date. For campaign/flow performance data that matches...12 params
Query and aggregate event data for a specific metric, with optional grouping by dimensions such as flows, campaigns, messages, etc. IMPORTANT: This endpoint returns data based on EVENT TIME (when events occurred), NOT send date. For campaign/flow performance data that matches...
Parameters* required
sortstringSort results by a grouping dimension. Prefix with '-' for descending order (e.g., '-$attributed_flow'). The sort value must also be included in the 'groupBy' parameter. Only dimension-based sorting is supported.one of
$attributed_channel · $attributed_flow · $attributed_message · $attributed_variation · $campaign_channel · $flowmodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherendDatestringEnd of the date range (exclusive) in ISO 8601 format without timezone offset, e.g. '2024-12-31T23:59:59'. Do not include a 'Z' suffix or timezone offset; use the timezone parameter instead. The date range must not exceed 1 year.
groupByarrayOptional dimensions to group by. Common groupings: '$attributed_flow' (flow attribution), '$attributed_message' (message attribution), '$message' (message ID), '$flow' (flow ID), 'Campaign Name', etc.
intervalstringTime interval for grouping results: 'hour', 'day' (default), 'week', or 'month'one of
hour · day · week · monthdefault: daymetricIdstringThe ID of the metric to aggregate. Use the get_metrics tool to find available metric IDs. Common metrics include 'Placed Order', 'Opened Email', 'Clicked Email', etc.
pageSizeintegerNumber of rows per page. Must be between 500 and 10,000 (default 500).default: 500
timezonestringTimezone for processing the query (e.g., 'America/New_York', 'US/Eastern'). Defaults to UTC.default: UTC
startDatestringStart of the date range (inclusive) in ISO 8601 format without timezone offset, e.g. '2024-01-01T00:00:00'. Do not include a 'Z' suffix or timezone offset; use the timezone parameter instead. The date range must not exceed 1 year.
pageCursorstringOnly used for pagination. If links.next is null then you've reached the last page of results. Otherwise, pass links.next to this parameter to get the next page.
measurementsarrayMeasurement types to compute: 'count' (number of events), 'sum_value' (sum of event values, e.g., order totals), 'unique' (unique profile count)
additionalFiltervalueOptional structured filter to narrow results by a single dimension. Only one additional filter is supported by the API.
klaviyo_subscribe_profile_to_marketingSubscribe a profile to marketing for a given channel. If a profile doesn't already exist, it will be created. Returns 'Success' if successful.6 params
Subscribe a profile to marketing for a given channel. If a profile doesn't already exist, it will be created. Returns 'Success' if successful.
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherlistIdstringThe ID of the list to subscribe the profile to if provided.
channelsarrayThe channels to subscribe the profile to.
profileIdstringThe ID of the profile to subscribe if the profile already exists and has an ID.
phoneNumberstringThe phone number of the profile to subscribe. Required if sms channel is included.
emailAddressstringThe email address of the profile to subscribe. Required if email channel is included.
klaviyo_unsubscribe_profile_from_marketingUnsubscribe a profile from marketing for a given channel. Returns 'Success' if successful.5 params
Unsubscribe a profile from marketing for a given channel. Returns 'Success' if successful.
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherlistIdstringThe ID of the list to unsubscribe the profile to if provided.
channelsarrayThe channels to unsubscribe the profile to.
phoneNumberstringThe phone number of the profile to unsubscribe. Required if sms channel is included.
emailAddressstringThe email address of the profile to unsubscribe. Required if email channel is included.
klaviyo_upload_image_from_urlUpload an image from a URL or data URI.3 params
Upload an image from a URL or data URI.
Parameters* required
namestringA name for the image. Defaults to the filename if omitted.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherimageURLstringThe URL of the image to upload
klaviyo_get_campaign_reportReturns metrics data for campaigns with the given filters and within the given timeframe. Can return performance data such as opens, clicks, and conversions, etc. This tool will also give you information about each campaign in the report, such as: audience names and IDs for th...9 params
Returns metrics data for campaigns with the given filters and within the given timeframe. Can return performance data such as opens, clicks, and conversions, etc. This tool will also give you information about each campaign in the report, such as: audience names and IDs for th...
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfiltersarraygroupByarrayList of attributes to group the data by. Results include a 'groupings' object with the values for each group-by attribute. Note: campaign_id and campaign_message_id and send_channel are required and will be automatically included if omitted. Use 'group_name' to get metrics broken down by audience (list/segment).
timeframevalueThe timeframe to query for data within. The max length a timeframe can be is 1 year. If unspecified, use 1 year.
statisticsarrayList of statistics to query for.
detailFiltersarrayFilters to apply to the campaign report. Contains-any does case-insensitive substring matching (for example, 'Test' will match 'test campaign'). Equals does case-insensitive exact matching. Unless explicitly stated, these filters should probably use contains-any.
groupByAudiencebooleanIf true, also return an aggregation of stats grouped by audience (list/segment) and send channel, combining data across campaigns.default: false
valueStatisticsarrayList of value statistics to query for. If you see an error about the conversion metric not supporting querying for values data, try again and leave this as an empty list.
conversionMetricIdstringID of the metric to be used for conversion statistics. You can get available metrics IDs using the get_metrics tool and just requesting the 'name' field. Do not use any additional filters on the get_metrics tool. If a specific metric is not requested, use the ID of the metric named 'Placed Order'. If it doesn't exist, use any metric.
klaviyo_get_flow_reportReturns metrics data for flows with the given filters and within the given timeframe. Can return performance data such as opens, clicks, and conversions, etc. This tool will also give you information about each flow in the report, such as: flow name, trigger type, and flow ID.8 params
Returns metrics data for flows with the given filters and within the given timeframe. Can return performance data such as opens, clicks, and conversions, etc. This tool will also give you information about each flow in the report, such as: flow name, trigger type, and flow ID.
Parameters* required
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherfiltersarraygroupByarrayList of attributes to group the data by. Results include a 'groupings' object with the values for each group-by attribute. Note: flow_id and flow_message_id are required and will be automatically included if omitted.
timeframevalueThe timeframe to query for data within. The max length a timeframe can be is 1 year. If unspecified, use 1 year.
statisticsarrayList of statistics to query for.
detailFiltersarrayFilters to apply to the flow report. Contains-any does case-insensitive substring matching (for example, 'Test' will match 'test campaign'). Equals does case-insensitive exact matching. Unless explicitly stated, these filters should probably use contains-any.
valueStatisticsarrayList of value statistics to query for. If you see an error about the conversion metric not supporting querying for values data, try again and leave this as an empty list.
conversionMetricIdstringID of the metric to be used for conversion statistics. You can get available metrics IDs using the get_metrics tool and just requesting the 'name' field. Do not use any additional filters on the get_metrics tool. If a specific metric is not requested, use the ID of the metric named 'Placed Order'. If it doesn't exist, use any metric.
mcp-klaviyo
Klaviyo MCP Pack — wraps the Klaviyo API for email marketing
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|---|
klaviyo_list_lists | Get all email lists in your account. Returns list IDs, names, subscriber counts, and creation dates. |
klaviyo_get_campaign | Get a campaign's full details by ID. Returns name, status, subject line, recipient list, performance stats, and send history. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"klaviyo": {
"url": "https://gateway.pipeworx.io/klaviyo/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Klaviyo data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
