HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
Guides

Klaviyo MCP server

Configure Klaviyo's MCP server to get AI assistance with your Klaviyo data.

You will learn

The Klaviyo Model Context Protocol (MCP) server seamlessly integrates with Klaviyo’s APIs, enabling AI clients to interact with your Klaviyo data. This guide will walk you through configuring various MCP clients for both the remote-hosted MCP server (recommended) and the local MCP server.

What is MCP?

MCP (Model Context Protocol) is an open protocol that helps AI models securely interface with different data sources and tools. You’ll connect Klaviyo’s MCP server to an MCP client, i.e., an AI agent like Claude or Cursor, to get assistance with your Klaviyo data. Your MCP client can help with a variety of tasks from campaign creation to flow performance reports. Here’s some examples of prompts you can give:

  • “Show me the performance of my email campaigns from the last 30 days.”
  • “Which flows are performing the best in terms of conversions?”
  • “Create an email campaign promoting our Memorial Day sale.”

Here’s an example of an MCP client working on a Klaviyo-related task using Klaviyo’s MCP tools:

Configure your MCP client for the remote-hosted server (recommended)

🚧

This feature is only available to Klaviyo users with an Owner, Admin, or Manager role. Learn more about Klaviyo user roles.

To communicate with the Klaviyo MCP server, each MCP client needs specific configuration. Follow the steps below to get started:

  1. Make sure you are logged in to the Klaviyo account you'd like to use.
  2. Follow the steps below for the MCP client you’d like to configure.

Claude

🚧

This feature is only available to Claude and Claude Desktop for users on Pro, Max, Team, and Enterprise plans.

  1. Navigate to claude.ai.

  2. Follow the instructions here to add a custom connector for the Klaviyo MCP server. The URL of the server is https://mcp.klaviyo.com/mcp. You will be prompted to authenticate with Klaviyo.

See Query parameters to choose any query parameters you'd like to add to control server behavior.

  1. Verify the connection by looking for visual indicators and asking a question to test the connection.

Cursor

  1. Download Cursor.

  2. Open Cursor. Within Settings > Cursor Settings > Tools & Integrations > New MCP Server, add the following:

{
  "mcpServers": {
    "klaviyo": {
      "url": "https://mcp.klaviyo.com/mcp"
    }
  }
}

See Query parameters to choose any query parameters you'd like to add to control server behavior.

  1. Save your changes and navigate to Settings > Cursor Settings > Tools & Integrations. Click Needs login. You will be prompted to authenticate the server.

  2. Verify the connection by looking for visual indicators and asking a question to test the connection.

VS Code

  1. Download VS Code.

  2. Open VS Code. Within settings (Ctrl + Shift + P > Preferences: Open Settings (JSON)), add the following:

{
  "mcp": {
    "servers": {
      "klaviyo": {
        "url": "https://mcp.klaviyo.com/mcp"
      }
    }
  }
}

See Query parameters to choose any query parameters you'd like to add to control server behavior.

  1. Save your changes. From the command palette (Ctrl+Shift+P on Windows or Cmd+Shift+P on Mac), search for MCP: List Servers, then select klaviyo > Start Server. You will be prompted to authenticate the server.

  2. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

To enable only the tools that do not modify any Klaviyo data, add the query parameter read-only=true to the URL in your MCP client’s configuration file.

Query parameters

You can control server behavior with query parameters.

ParameterOptionsDefault valueDescription
read-onlytrue, falsefalseSetting this value to true disables any tools which can perform write actions on your Klaviyo account.
disable-tools-with-user-generated-contenttrue, falsefalseDisables specific tools that read user-generated content in your Klaviyo account that could be interpreted by your LLM (see Available tools). Be sure to carefully review each tool call to ensure your client is not acting on malicious instructions.

Here's an example of what your URL may look like:

https://mcp.klaviyo.com/mcp?read-only=true&disable-tools-with-user-generated-content=true

Configure your MCP client for the local server

To use the local MCP server, you’ll need:

  • uv
  • A compatible MCP client (e.g., Cursor). For web-based clients such as ChatGPT, use our remote-hosted server.

To communicate with the Klaviyo MCP server, each MCP client needs specific configuration. Follow the steps below to get started:

  1. To utilize all available tools, create a Klaviyo private API key with the following permissions:
ScopeAccess
AccountsRead
CampaignsFull
CatalogsRead
EventsFull
FlowsRead
ImagesFull
ListRead
MetricsRead
ProfilesFull
SegmentsFull
SubscriptionsFull
TagsRead
TemplatesFull
  1. Follow the steps below for the MCP client you’d like to configure.

📘

You can add multiple Klaviyo accounts to your MCP client's configuration file to switch between accounts without editing the file each time. Just be sure to reference the desired account in each prompt.

Claude Desktop

  1. Download Claude Desktop.

  2. Open Claude Desktop. Within Settings > Developer > Edit Config, add the following, substituting your API key:

{
 "mcpServers": {
   "klaviyo": {
     "command": "uvx",
     "args": ["klaviyo-mcp-server@latest"],
     "env": {
       "PRIVATE_API_KEY": "YOUR_API_KEY",
       "READ_ONLY": "false",
       "ALLOW_USER_GENERATED_CONTENT": "false"
     }
   }
 }
}
  1. Once you have saved all configuration changes, terminate all Claude processes and relaunch Claude to apply the new settings.

  2. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

If you get errors upon starting Claude, you may need to provide the full path to the uvx executable for the command key. On macOS, find this by running which uvx.

  1. (Recommended for security) To avoid storing your API key in plaintext, save your API key in your password manager. Then, use the following command to launch Claude, pasting in your API key when prompted:
uvx --from klaviyo-mcp-server@latest run-claude

Note that as of now, this only supports MacOS and Windows.

📘

Note for free users

The free version of Claude Desktop has a very limited context window, and you may run into issues with all the tools enabled. Here are a few possible workarounds:

  1. Only enable the tools you need. To do this, click the Search and tools button near the prompt. Then, click klaviyo to toggle certain tools on or off.
  2. Use read-only mode, i.e., set READ_ONLY to true.
  3. Use a different client.

Cursor

  1. Download Cursor.

  2. Open Cursor. Within Settings > Cursor Settings > Tools & Integrations > Add Custom MCP, add the following, substituting your API key:

{
  "mcpServers": {
    "klaviyo": {
      "command": "uvx",
      "args": ["klaviyo-mcp-server@latest"],
      "env": {
        "PRIVATE_API_KEY": "YOUR_API_KEY",
        "READ_ONLY": "false",
        "ALLOW_USER_GENERATED_CONTENT": "false"
      }
    }
  }
}
  1. Once you have saved all configuration changes, terminate all Cursor processes and relaunch Cursor to apply the new settings.

  2. Verify the connection by looking for visual indicators and asking a question to test the connection.

  3. (Recommended for security) To avoid storing your API key in plaintext, save your API key in your password manager. Then, use the following command to launch Cursor, pasting in your API key when prompted:

uvx --from klaviyo-mcp-server@latest run-cursor

Note that as of now, this only supports MacOS and Windows.

VS Code

  1. Download VS Code.

  2. Open VS Code. Within settings (Ctrl + Shift + P > Preferences: Open Settings (JSON)), add the following:

{
  "mcp": {
    "servers": {
      "klaviyo": {
        "command": "uvx",
        "args": ["klaviyo-mcp-server@latest"],
        "env": {
          "PRIVATE_API_KEY": "${input:klaviyo_api_key}",
          "READ_ONLY": "false",
          "ALLOW_USER_GENERATED_CONTENT": "false"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "klaviyo_api_key",
        "description": "Klaviyo API Key",
        "password": true
      }
    ]
  }
}
  1. Once you have saved all configuration changes, terminate all VS Code processes and relaunch VS Code to apply the new settings.

  2. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

To enable only the tools that do not modify any Klaviyo data, set the READ_ONLY environment variable to true in your MCP client’s configuration file.

Environment configuration

The Klaviyo MCP server provides some configuration options which can be controlled with environment variables.

envOptionsDefault valueDescription
READ_ONLYtrue, falsefalseSetting this value to true disables any tools which can perform write actions on your Klaviyo account.
ALLOW_USER_GENERATED_CONTENTtrue, falsetrueSetting this value to false disables specific tools from reading and interpreting user-generated content in your Klaviyo account using your LLM (see Available tools). If left as true, be sure to carefully review each tool call to ensure your client is not acting on malicious instructions.

Add multiple accounts to your configuration file

To avoid editing your MCP client's configuration file each time you switch Klaviyo accounts, you can add multiple accounts to the file.

To do this:

  1. Copy and paste the same configuration shown above for each account you want to add.
  2. Update the name, i.e., klaviyo, to something more descriptive for each account, and replace the API keys accordingly.

Your config file should look like this:

{ 
  "mcpServers": { 
    "klaviyo_company1": { 
      "command": "uvx", 
      "args": ["klaviyo-mcp-server@latest"], 
      "env": { 
        "PRIVATE_API_KEY": "YOUR_API_KEY_1", 
        "READ_ONLY": "false", 
        "ALLOW_USER_GENERATED_CONTENT": "false" 
      } 
    },
    "klaviyo_company2": { 
      "command": "uvx", 
      "args": ["klaviyo-mcp-server@latest"], 
      "env": { 
        "PRIVATE_API_KEY": "YOUR_API_KEY_2", 
        "READ_ONLY": "false", 
        "ALLOW_USER_GENERATED_CONTENT": "false" 
      } 
    }
  } 
}

Troubleshooting

If your MCP client can’t find enabled MCP tools for Klaviyo:

  1. Review the steps above and ensure the MCP server is configured correctly.
  2. Terminate all processes and relaunch the app to refresh your client.

If you’re getting inaccurate or inconsistent responses:

  • Start a new chat to reset the conversation context.
  • Make sure you’re being specific in your queries by providing necessary, relevant keywords.

Available tools

CategoryTool nameDescriptionRead OnlyHas User Generated ContentAvailable on Remote Server
Accountsget_account_detailsGet details of your account.
Campaignsget_campaignsList your campaigns.
Campaignsget_campaignGet details of a campaign.
Campaignscreate_campaignCreate a campaign.
Campaignsassign_template_to_campaign_messageAssign an email template to a campaign message.
Catalogsget_catalog_itemsList your catalog items.
Eventsget_eventsList events.
Eventscreate_eventCreate an event for a profile.
Eventsget_metricsList event metrics.
Eventsget_metricGet details of an event metric.
Flowsget_flowsList your flows.
Flowsget_flowGet details of a flow.
Groupsget_listsList your lists.
Groupsget_listGet details of a list.
Groupsget_segmentsList your segments.
Groupsget_segmentGet details of a segment.
Imagesupload_image_from_fileUpload image from a local file.
Imagesupload_image_from_urlUpload image from a URL.
Profilesget_profilesList your profiles.
Profilesget_profileGet details of a profile.
Profilescreate_profileCreate a profile.
Profilesupdate_profileUpdate a profile.
Profilessubscribe_profile_to_marketingSubscribe a profile to marketing for a given channel and list.
Profilesunsubscribe_profile_from_marketingUnsubscribe a profile from marketing for a given channel and list.
Reportingget_campaign_reportGet a report of your campaign performance.
Reportingget_flow_reportGet a report of your flow performance.
Templatescreate_email_templateCreate an HTML email template.
Templatesget_email_templateGet the details of an email template.