Klaviyo MCP Server

What does “Klaviyo” MCP Server do?

The Klaviyo MCP Server revolutionizes email marketing automation by connecting Klaviyo’s powerful platform with AI assistants and developer tools through the Model Context Protocol (MCP). This integration empowers marketing teams to manage sophisticated email campaigns, customer profiles, automation flows, and audience segments using natural language commands instead of navigating multiple dashboards. Whether you’re creating personalized campaigns, tracking customer events, building complex segments, or orchestrating multi-step automation flows, the Klaviyo MCP Server enables you to execute these tasks directly from AI tools like Claude, Cursor, or FlowHunt. By eliminating context switching and enabling AI-powered automation, marketing teams can reduce campaign setup time from hours to minutes while maintaining full control over their customer engagement strategy.

List of Prompts

Profile and Customer Management

Find all customer profiles who haven't opened emails in 90 days

Create a new profile for customer@example.com with custom properties for VIP status

Show me all profiles who purchased in the last 30 days but haven't received a follow-up email

Update all profiles in the VIP segment to add a loyalty tier property

Campaign Management

Create a new email campaign for Black Friday with subject line 'Exclusive 40% Off' targeting VIP customers

Show me all campaigns sent in the last 7 days with open rates below 15%

Send the 'Welcome Series Part 1' campaign immediately to all new subscribers

Cancel the scheduled campaign for tomorrow and reschedule it for next week

List and Segmentation

Create a new list called 'Q1 2026 Re-engagement' for inactive subscribers

Add all profiles who clicked our last email but didn't purchase to the 'Hot Leads' list

Show me all segments with more than 5000 profiles and their criteria

Email Template Operations

Create a new email template for our product launch with HTML content

Show me all templates used in campaigns with conversion rates above 5%

Update the 'Holiday Promotion' template with new discount code HOLIDAY2026

Event Tracking and Analytics

Track a 'Product Viewed' event for all profiles who visited our new collection page

Show me all 'Purchase' events from the last 30 days with order values above $100

Get all metrics for email performance and show me which campaigns drove the most revenue

Flow Automation

Show me all active automation flows and their conversion rates

Pause the 'Cart Abandonment' flow while we update the email templates

Set the 'Welcome Series' flow to live status and enable it for new subscribers

List of Resources

No explicit resources are listed in the repository.

List of Tools

The Klaviyo MCP Server provides 39 comprehensive tools organized into eight categories:

Profile Management (5 tools)

• get_profiles - Retrieve a list of customer profiles with optional filtering and pagination
• get_profile - Get detailed information about a specific customer profile by ID
• create_profile - Create a new customer profile with email, phone, custom properties, and more
• update_profile - Update existing profile attributes like name, email, or custom properties
• Profile filtering - Advanced filtering capabilities using Klaviyo’s filter syntax

List Management (7 tools)

• get_lists - Retrieve all email lists in your Klaviyo account
• get_list - Get details of a specific list by ID
• create_list - Create a new email list for organizing contacts
• update_list - Update list properties including name
• delete_list - Permanently remove a list from your account
• add_profile_to_list - Add a customer profile to a specific list
• remove_profile_from_list - Remove a profile from a list

Campaign Management (7 tools)

• get_campaigns - Retrieve campaigns with optional filtering
• get_campaign - Get detailed information about a specific campaign
• create_campaign - Create a new email campaign with subject, sender details, and preview text
• update_campaign - Update campaign attributes like name, subject, or content
• send_campaign - Send a campaign immediately to the target audience
• cancel_campaign - Cancel a scheduled campaign before it sends
• assign_template_to_campaign - Attach an email template to a campaign message

Event Tracking (2 tools)

• create_event - Track custom events for profiles with properties and timestamps
• get_events - Retrieve events with filtering and pagination for analysis

Metrics & Analytics (2 tools)

• get_metrics - Retrieve all available Klaviyo metrics for performance tracking
• get_metric - Get detailed information about a specific metric by ID

Segment Management (2 tools)

• get_segments - Retrieve all customer segments in your account
• get_segment - Get detailed information about a specific segment including criteria

Flow Automation (3 tools)

• get_flows - Retrieve all automation flows with optional filtering and pagination
• get_flow - Get detailed information about a specific automation flow
• update_flow_status - Change flow status between live, manual, and draft modes

Template Management (5 tools)

• get_templates - Retrieve all email templates in your account
• get_template - Get detailed information about a specific template
• create_template - Create a new email template with HTML and text content
• update_template - Update template attributes including HTML, text, and name
• delete_template - Permanently remove a template from your account

Use Cases of this MCP Server

When You Have 100+ Inactive Subscribers Needing Re-Engagement

You’re staring at thousands of inactive subscribers clogging your list, hurting deliverability. Instead of manually creating segments, filters, and multi-touch campaigns, ask: “Find all profiles who haven’t opened emails in 90 days, create a segment called ‘Re-engagement Q1 2026’, and set up a three-email winback campaign using our reactivation template.” The MCP server builds the segment, creates the campaigns, assigns templates, and prepares the entire re-engagement sequence in under 2 minutes—work that traditionally takes 2-3 hours.

When a Product Launch Requires Segmentation by Purchase History

Your new premium product launches tomorrow and you need to target customers based on their lifetime value and previous purchases. Simply say: “Create segments for customers who spent over $500 in the past year but haven’t purchased in 60 days, and another for customers who bought our starter product but never upgraded.” The server instantly creates both segments, letting you tailor messaging for each group—critical work that usually requires complex filter building and multiple rounds of QA.

When Analyzing Which Email Templates Drive the Most Conversions

You’ve sent dozens of campaigns and need to identify your best-performing templates to replicate success. Ask: “Show me all campaigns sent in Q4 2025, their assigned templates, and their conversion metrics.” Instead of exporting data, cross-referencing template IDs, and building spreadsheets manually, you get instant analysis showing which templates consistently outperform, enabling data-driven creative decisions without the usual 4-5 hour analysis process.

When You Need to Sync Event Data from Your App to Trigger Automated Flows

Your SaaS application tracks critical user behaviors—trial starts, feature adoption, usage milestones—and you need these events in Klaviyo to trigger personalized nurture flows. Command: “Create a ‘Feature X Activated’ event for all profiles in my power users segment with timestamp and feature properties.” The MCP server batch-creates events with proper attribution, enabling sophisticated behavioral marketing without writing custom API scripts or waiting for engineering resources.

When Managing Multiple Brands and Need to Duplicate Winning Campaigns

You manage three distinct brands under one company, and Brand A’s holiday campaign crushed it with 42% open rates. Instead of manually recreating the campaign structure for Brands B and C, say: “Get campaign ID abc123, show me its structure, template, and settings, then help me create identical campaigns for my Brand B and Brand C lists.” The server retrieves all campaign details and helps you replicate success across brands in minutes instead of hours of copying, pasting, and double-checking settings.

When Black Friday Is Coming and You Need 20 Variations of Promotional Emails

Peak season demands multiple email variations for different segments—new customers, VIPs, window shoppers, abandoned carts. Rather than manually creating 20 separate campaigns through the UI, instruct: “Create campaigns for Black Friday targeting these 5 segments: VIP customers, repeat buyers, one-time purchasers, email subscribers who never bought, and cart abandoners. Use our holiday template and customize subject lines for each.” The MCP server generates all campaigns with appropriate targeting and templates, reducing 6+ hours of repetitive work to 15 minutes of AI-guided campaign creation.

When You Discover a Critical Template Error After Sending to 10,000 Subscribers

You sent a campaign and realized the promo code in your template is wrong. You have 15 more scheduled campaigns using that same template. Instead of manually updating each campaign or panicking, say: “Show me all campaigns scheduled for the next 7 days using template ID xyz789, then update the template to change PROMO20 to PROMO25.” The server identifies affected campaigns and updates the master template instantly, preventing 15 potential disasters without manually auditing your campaign calendar.

When Building Complex Segment Logic for a Multi-Touch Campaign

Your retention campaign targets customers who received your last email, opened it, clicked through, but didn’t complete checkout—and they also purchased in the past but not in the last 45 days. Building this multi-condition segment through Klaviyo’s UI means navigating nested filters and conditional logic. Instead, describe your criteria naturally: “Create a segment of profiles who opened campaign ID abc123, clicked any link, have at least one past order, but no orders in the last 45 days and no checkout completion.” The AI translates your natural language into proper segment criteria, eliminating filter-building frustration.

When Coordinating a Product Discontinuation Email Sequence

You’re discontinuing a product line and need to notify affected customers, offer alternatives, and provide a last-chance purchase window. Command: “Find all profiles who purchased product SKU 12345 in the past 2 years, create a list called ‘Product Discontinuation - SKU 12345’, and set up a 3-email sequence: announcement, alternatives, last chance.” The MCP server identifies affected customers, organizes them into a targetable list, and structures your sunset campaign—strategic work that typically requires data exports, CSV uploads, and manual campaign configuration.

When Your Email Metrics Suddenly Drop and You Need Root Cause Analysis

Your typical 25% open rate plummeted to 12% over the past week and leadership wants answers. Ask: “Show me all campaigns sent in the past 14 days with their open rates, click rates, and send times. Compare this to campaigns from the previous 30 days.” The server delivers comparative metrics across campaigns, helping you identify patterns—maybe send time changed, certain segments stopped engaging, or specific templates underperform—surfacing insights that usually require exporting multiple reports and building comparison charts.

When Managing Flow Statuses During Platform Migrations or Major Updates

You’re migrating to a new CRM and need to pause 30+ automation flows to prevent duplicate communications during the transition. Rather than clicking through each flow individually in the Klaviyo dashboard, say: “Show me all active flows, then set flows containing ‘abandoned cart’, ‘welcome series’, and ‘post-purchase’ to draft status.” The MCP server batch-updates flow statuses, giving you precise control during critical operations without the risk of missing a flow in manual updates.

When Creating Personalized Event-Driven Campaigns for Webinar Attendees

You hosted a webinar with 500 attendees, and you need to track who attended, what topics they engaged with, and trigger personalized follow-up campaigns. Instruct: “Create a ‘Webinar Attended - AI Marketing’ event for these 500 profile IDs with properties including attendance duration and poll responses, then create a segment of attendees who stayed over 30 minutes.” The server processes bulk event creation with custom properties and builds actionable segments, enabling sophisticated behavioral follow-up without manual data entry or complex CSV imports.

When Auditing Email Deliverability Across Multiple Lists

You suspect deliverability issues because engagement varies wildly across your 15 different email lists. Some lists have 35% open rates, others barely hit 8%. Ask: “Show me all my lists, their subscriber counts, and recent campaign performance for each list in the past 30 days.” The MCP server aggregates list data and associated campaign metrics, revealing which lists need cleaning, which are highly engaged, and where to focus deliverability efforts—insights that typically require exporting multiple reports and hours of manual cross-referencing.

When Scaling Personalized Campaigns Based on Customer Lifecycle Stage

You’re moving from batch-and-blast to lifecycle marketing and need to create 8 different campaign series for prospects, new customers, active users, at-risk customers, churned customers, VIPs, referrers, and brand advocates. Instead of manually building each series through the UI, collaborate with the AI: “Help me create campaign structures for 8 lifecycle stages. For each stage, I’ll provide the segment criteria and messaging angle, and you create the campaigns with appropriate templates and sending schedules.” The MCP server accelerates sophisticated lifecycle program buildout from weeks to days.

When Running A/B Tests Across Multiple Audience Segments Simultaneously

You’re testing subject line approaches—urgency vs. benefit-driven vs. personalization—across 6 different customer segments to understand what resonates with each group. Rather than creating 18 campaigns manually, say: “Create A/B test campaigns for these 6 segments using three subject line variations: urgency, benefit, and personalization. Use our standard promotional template for all.” The MCP server generates the entire test matrix, enabling sophisticated multivariate testing without drowning in campaign creation work.

How to set it up

Windsurf

1. Ensure Python 3.10 or higher is installed on your system.
2. Install the Klaviyo MCP server from your repository.
3. Obtain OAuth credentials from your Klaviyo account:
   • Navigate to Account Settings > API Keys in Klaviyo
   • Create a new API key with appropriate permissions
   • Note your Client ID, Client Secret, and Access Token
4. Add the Klaviyo MCP server to your mcpServers configuration:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"""
         }
       }
     }
   }
   

5. Save the configuration file and restart Windsurf.
6. Verify the MCP server is listed and accessible in Windsurf’s MCP panel.

Claude

1. Ensure Python 3.10 or higher is installed.
2. Install the Klaviyo MCP server.
3. Configure your Klaviyo OAuth credentials as described above.
4. Add or update the mcpServers field in your Claude configuration:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

5. Save the configuration and restart Claude.
6. Confirm the MCP server connection in Claude’s integrations panel.

Cursor

1. Install Python 3.10+ and the Klaviyo MCP server.
2. Set up your Klaviyo OAuth credentials.
3. Locate Cursor’s configuration file and add the MCP server entry:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

4. Save the configuration and restart Cursor.
5. Ensure the server appears under Cursor’s available MCP servers.

Cline

1. Ensure Python 3.10+ is present on your system.
2. Download or install the Klaviyo MCP server.
3. Obtain your Klaviyo OAuth credentials.
4. Modify Cline’s configuration to include:

   {
     "mcpServers": {
       "klaviyo-mcp": {
         "command": "python3",
         "args": ["-m", "klaviyo_mcp_server"],
         "env": {
           "KLAVIYO_CLIENT_ID": "your_client_id",
           "KLAVIYO_CLIENT_SECRET": "your_client_secret",
           "KLAVIYO_ACCESS_TOKEN": "your_access_token"
         }
       }
     }
   }
   

5. Save the configuration, restart Cline, and check MCP server connectivity.

Securing API Keys (using environment variables):

To protect your Klaviyo credentials, always use environment variables rather than hardcoding them. Example secure configuration:

{
  "mcpServers": {
    "klaviyo-mcp": {
      "command": "python3",
      "args": ["-m", "klaviyo_mcp_server"],
      "env": {
        "KLAVIYO_CLIENT_ID": "${KLAVIYO_CLIENT_ID}",
        "KLAVIYO_CLIENT_SECRET": "${KLAVIYO_CLIENT_SECRET}",
        "KLAVIYO_ACCESS_TOKEN": "${KLAVIYO_ACCESS_TOKEN}",
        "KLAVIYO_REFRESH_TOKEN": "${KLAVIYO_REFRESH_TOKEN}"
      }
    }
  }
}

Set these environment variables in your system or shell profile before launching your MCP client.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate the Klaviyo MCP server into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your Klaviyo MCP server details using this JSON format:

{
  "klaviyo-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/klaviyo-mcp"
  }
}

Once configured, your AI agent gains access to all 39 Klaviyo tools, enabling it to create campaigns, manage customer profiles, track events, orchestrate flows, and analyze metrics—all within your automated workflows. This transforms your FlowHunt flows into powerful marketing automation engines that can respond to triggers, segment audiences, and execute campaigns without manual intervention.

Overview

Between the documentation and the code, the Klaviyo MCP Server provides comprehensive tool coverage with 39 distinct operations spanning profile management, campaign automation, list management, event tracking, metrics analysis, segmentation, flow orchestration, and template management. The server uses OAuth authentication with secure credential management through environment variables.

Our opinion

This MCP server excels in breadth and depth of marketing automation capabilities, offering the most comprehensive Klaviyo integration available through the Model Context Protocol. With 39 well-documented tools organized into logical categories, marketing teams gain unprecedented control over their email marketing operations through natural language interfaces. The OAuth implementation ensures enterprise-grade security, while the extensive tool coverage eliminates the need for manual dashboard work in most scenarios. This server is ideal for marketing teams, marketing operations professionals, and developers building marketing automation workflows who want to leverage AI for campaign management, customer segmentation, and engagement optimization. The lack of built-in prompt templates is offset by the intuitive tool naming and clear descriptions that make natural language interaction straightforward.

MCP Score