klaviyo-mcp-server 0.2.5

Klaviyo MCP Server

Klaviyo MCP Server (Beta)

The Klaviyo Model Context Protocol (MCP) server integrates with Klaviyo's APIs, allowing you to interact with your Klaviyo data using a variety of MCP clients. For a detailed guide on how to set up and use this server, see our Klaviyo MCP server guide.

[!WARNING] The Klaviyo MCP server is currently in beta and is subject to change. Please provide any feedback using this form.

Prerequisites

• uv
• A compatible MCP client (e.g., Cursor). Note: This server runs locally, so web-based clients such as ChatGPT are not supported at this time.

Quickstart

Create a Klaviyo private API key

To utilize all available tools, create a Klaviyo private API key with the following permissions:

Scope	Access
Accounts	Read
Campaigns	Full
Catalogs	Read
Events	Full
Flows	Read
Images	Full
List	Read
Metrics	Read
Profiles	Full
Segments	Full
Subscriptions	Full
Tags	Read
Templates	Full

Install uv

For macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

For Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Add the server to your MCP client

For guidance on securely configuring your MCP client, refer to our Klaviyo MCP server guide.

Available tools

Category	Tool name	Description
Accounts	get_account_details	Get details of your account.
Campaigns	get_campaigns	List your campaigns.
Campaigns	get_campaign	Get details of a campaign.
Campaigns	create_campaign	Create a campaign.
Campaigns	assign_template_to_campaign_message	Assign an email template to a campaign message.
Catalogs	get_catalog_items	List your catalog items.
Events	get_events	List events.
Events	create_event	Create an event for a profile.
Events	get_metrics	List event metrics.
Events	get_metric	Get details of an event metric.
Flows	get_flows	List your flows.
Flows	get_flow	Get details of a flow.
Groups	get_lists	List your lists.
Groups	get_list	Get details of a list.
Groups	get_segments	List your segments.
Groups	get_segment	Get details of a segment.
Images	upload_image_from_file	Upload image from a local file.
Images	upload_image_from_url	Upload image from a URL.
Profiles	get_profiles	List your profiles.
Profiles	get_profile	Get details of a profile.
Profiles	create_profile	Create a profile.
Profiles	update_profile	Update a profile.
Profiles	subscribe_profile_to_marketing	Subscribe a profile to marketing for a given channel and list.
Profiles	unsubscribe_profile_from_marketing	Unsubscribe a profile from marketing for a given channel and list.
Reporting	get_campaign_report	Get a report of your campaign performance.
Reporting	get_flow_report	Get a report of your flow performance.
Templates	create_email_template	Create an HTML email template.
Templates	get_email_template	Get the details of an email template.