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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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
campaignMessageFieldsarrayFields to return for associated campaign messages.
channelstringWhich types of campaigns to return. To get all types of campaigns, call this tool for each channel.one of
email · sms · mobile_pushfieldsarrayFields to return.
filtersarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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_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
campaignMessageIdstringThe ID of the email campaign message to assign the template to.
emailTemplateIdstringThe ID of the email template to assign to the campaign message.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_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
fieldsarrayFields to return.
filtersarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
pageSizeintegerNumber of results to return per page (1-100)
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
fieldsarrayFields to return.
filterarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
sortstringWhat to sort by.one of
created · -created · id · -id · name · -nameklaviyo_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
idstringincludeProfileCountbooleanWhether to include the number of profiles. Only set to true if this is requested.default: false
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_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
fieldsarrayFields to return.
filterarraymetricFieldsarrayFields to return for associated metrics.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
profileFieldsarrayFields to return for associated profiles.
sortstringWhat to sort by.one of
datetime · -datetime · timestamp · -timestampklaviyo_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
catalogVariantFieldsarrayFields to return for associated catalog variants.
fieldsarrayFields to return.
filterarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
sortstringWhat to sort by.one of
created · -createdklaviyo_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
hasEditableRegionsbooleanWhether the template HTML contains editable regions. Should be false unless they explicitly request an editable/drag-and-drop/hybrid template.default: false
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 r...
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othernamestringThe name of the template
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
fieldsarrayFields to return.
filtersarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
pageSizeintegerNumber of results to return per page (1-100)default: 5
sortstringWhat to sort by.one of
created · -created · email · -email · id · -idklaviyo_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
fieldsarrayFields to return.
filtersarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
sortstringWhat to sort by.one of
created · -created · id · -id · name · -nameklaviyo_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
includeProfileCountbooleanWhether to include the number of profiles. Only set to true if this is requested.default: false
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othersegmentIdstringklaviyo_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
fieldsarrayFields to return.
filterarraymodelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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
metricIdstringThe ID of the metric to return
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherklaviyo_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
additionalFiltervalueOptional structured filter to narrow results by a single dimension. Only one additional filter is supported by the API.
endDatestringEnd 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 dat...
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: daymeasurementsarrayMeasurement types to compute: 'count' (number of events), 'sum_value' (sum of event values, e.g., order totals), 'unique' (unique profile count)
metricIdstringThe 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.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherpageCursorstringOnly 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.
pageSizeintegerNumber of rows per page. Must be between 500 and 10,000 (default 500).default: 500
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...one of
$attributed_channel · $attributed_flow · $attributed_message · $attributed_variation · $campaign_channel · $flowstartDatestringStart 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 d...
timezonestringTimezone for processing the query (e.g., 'America/New_York', 'US/Eastern'). Defaults to UTC.default: UTC
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
channelsarrayThe channels to subscribe the profile to.
emailAddressstringThe email address of the profile to subscribe. Required if email channel is included.
listIdstringThe ID of the list to subscribe the profile to if provided.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherphoneNumberstringThe phone number of the profile to subscribe. Required if sms channel is included.
profileIdstringThe ID of the profile to subscribe if the profile already exists and has an ID.
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
channelsarrayThe channels to unsubscribe the profile to.
emailAddressstringThe email address of the profile to unsubscribe. Required if email channel is included.
listIdstringThe ID of the list to unsubscribe the profile to if provided.
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherphoneNumberstringThe phone number of the profile to unsubscribe. Required if sms 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
imageURLstringThe URL of the image to upload
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · othernamestringA name for the image. Defaults to the filename if omitted.
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
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 ge...
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...
filtersarraygroupByarrayList 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 an...
groupByAudiencebooleanIf true, also return an aggregation of stats grouped by audience (list/segment) and send channel, combining data across campaigns.default: false
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherstatisticsarrayList of statistics to query for.
timeframevalueThe timeframe to query for data within. The max length a timeframe can be is 1 year. If unspecified, use 1 year.
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.
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
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 ge...
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 expl...
filtersarraygroupByarrayList 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 i...
modelstringThe name of the LLM currently using the tool.one of
claude · gpt · gemini · otherstatisticsarrayList of statistics to query for.
timeframevalueThe timeframe to query for data within. The max length a timeframe can be is 1 year. If unspecified, use 1 year.
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.
mcp-klaviyo
Klaviyo MCP Pack — wraps the Klaviyo API for email marketing
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
klaviyo_list_profiles | Search contacts by email, name, or custom attributes. Returns profile IDs, emails, names, and properties with pagination support. |
klaviyo_get_profile | Get a contact's full profile by ID. Returns email, name, phone, custom properties, list memberships, and subscription status. |
klaviyo_list_lists | Get all email lists in your account. Returns list IDs, names, subscriber counts, and creation dates. |
klaviyo_list_campaigns | Search campaigns by status (draft, scheduled, sent). Returns campaign IDs, names, status, send dates, and performance metrics. |
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"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/klaviyo/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Klaviyo data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →