Klaviyo MCP Server

Name: Klaviyo MCP Server
Author: Klaviyo Developer Experience Team

Klaviyo's own MCP server for reading and editing campaigns, profiles, flows and reports in a Klaviyo account

Official · Klaviyo Developer Experience Team Python Remote (hosted) · Streamable HTTP Local · stdio CRM and sales Data and analytics

PyPI Website

40 popularity score ↓ 9.3k/mo

Connect your client

Remote (hosted)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude (desktop and web)Settings > Connectors: Browse Connectors and pick Klaviyo, or Add custom connector with the URL

https://mcp.klaviyo.com/mcp

ChatGPTSettings > Apps: Klaviyo app, or Create app with Developer mode on and OAuth selected

https://mcp.klaviyo.com/mcp

CursorSettings > Cursor Settings > MCP > New MCP Server

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

VS CodeMCP: Open User Configuration

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

Local (PyPI)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs PRIVATE_API_KEY. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add klaviyo -e PRIVATE_API_KEY=<PRIVATE_API_KEY> -- uvx klaviyo-mcp-server@latest

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "klaviyo": {
      "command": "uvx",
      "args": [
        "klaviyo-mcp-server@latest"
      ],
      "env": {
        "PRIVATE_API_KEY": "<PRIVATE_API_KEY>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "klaviyo": {
      "command": "uvx",
      "args": [
        "klaviyo-mcp-server@latest"
      ],
      "env": {
        "PRIVATE_API_KEY": "<PRIVATE_API_KEY>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "klaviyo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "klaviyo-mcp-server@latest"
      ],
      "env": {
        "PRIVATE_API_KEY": "<PRIVATE_API_KEY>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.klaviyo]
command = "uvx"
args = ["klaviyo-mcp-server@latest"]

[mcp_servers.klaviyo.env]
PRIVATE_API_KEY = "<PRIVATE_API_KEY>"

Gemini CLITerminal

gemini mcp add --scope user -e PRIVATE_API_KEY=<PRIVATE_API_KEY> klaviyo uvx -- klaviyo-mcp-server@latest

Settings 3

`PRIVATE_API_KEY`	Required: Klaviyo private API key; the server starts without it but every tool call fails.
`READ_ONLY`	Optional: Set to true to hide every tool that writes; default false.
`ALLOW_USER_GENERATED_CONTENT`	Optional: Set to false to hide tools that read profile and event data written by others; default true.

What it does

Klaviyo publishes this server itself and labels it beta. It connects an MCP client to the Klaviyo marketing platform so the assistant can look up account details, campaigns, flows, lists, segments, catalog items, events and metrics, pull campaign and flow performance reports, and make changes such as creating campaigns, email templates, events and profiles or subscribing and unsubscribing profiles from marketing.

It comes in two forms that are not the same size. The PyPI package klaviyo-mcp-server runs on your own machine over stdio and signs in with a Klaviyo private API key; version 0.4.1 registers 28 tools (counted in that release's tools folder), the same set its README lists. The hosted endpoint at https://mcp.klaviyo.com/mcp signs in with OAuth and, per Klaviyo's tools page, exposes more than 260 tools, including ones the local package lacks such as send_campaign, delete_campaign and catalog, coupon and translation tools. By default it loads a core set of about 40; query parameters such as read-only=true, toolsets=profiles:read,campaigns:read and beta=true change what it offers.

Both forms have a read-only switch (READ_ONLY=true locally, read-only=true on the hosted URL) and a switch that hides the tools which read user-generated content such as profile properties and event data, which Klaviyo flags as a prompt-injection risk.

What it needs

To run it yourself	Python

Local: uv (the command is uvx), a Klaviyo account and a private API key with the scopes the docs list (Campaigns, Events, Images, Profiles, Segments, Subscriptions and Templates at Full; the rest Read). Hosted: a Klaviyo user with the Owner, Admin or Manager role; Claude custom connectors need a Pro, Max, Team or Enterprise plan; ChatGPT custom servers need Developer mode turned on in Settings > Apps.

Limits

Beta and subject to change, per its README. The local package does not work with web clients such as ChatGPT. Version 0.4.1 has 28 tools: the larger set, beta tools and local beta setting on Klaviyo's tools page are not in that release's code, and it cannot send or delete a campaign. Its code registers each tool with a klaviyo_ prefix (klaviyo_get_profiles) and adds a required model argument (claude, gpt, gemini or other) that it puts in the User-Agent sent to Klaviyo. The run-claude and run-cursor launchers, which prompt for the key instead of storing it, work on macOS and Windows only. Query parameters cannot be set on the listed Claude connector or ChatGPT app.

Who it suits

Klaviyo marketers and developers who want an assistant to report on campaign and flow results or draft campaigns, templates and profile changes. The hosted endpoint suits most people: it has far more tools, OAuth sign-in and works in web clients, but needs an Owner, Admin or Manager role. The local package suits those who must use a scoped private key or a client without remote-server support, and accept a 28-tool set. For read-only reporting, turn on the read-only switch.

Tools 28

get_account_details: Shows details of the connected Klaviyo account
get_campaigns: Lists campaigns
get_campaign: Fetches one campaign
create_campaign: Creates a new campaign
assign_template_to_campaign_message: Attaches an email template to a campaign message
get_catalog_items: Lists catalog items
get_events: Lists events
create_event: Records an event against a profile
get_metrics: Lists event metrics
get_metric: Fetches one event metric
get_flows: Lists flows
get_flow: Fetches one flow
get_lists: Lists subscriber lists
get_list: Fetches one list
get_segments: Lists segments
get_segment: Fetches one segment
upload_image_from_file: Uploads an image from a file on your machine (local server only)
upload_image_from_url: Uploads an image from a web address
get_profiles: Lists profiles
get_profile: Fetches one profile
create_profile: Creates a profile
update_profile: Changes a profile's fields
subscribe_profile_to_marketing: Opts a profile in to marketing on a channel and list
unsubscribe_profile_from_marketing: Opts a profile out of marketing on a channel and list
get_campaign_report: Returns campaign performance figures
get_flow_report: Returns flow performance figures
create_email_template: Creates an HTML email template
get_email_template: Fetches one email template

Popularity

40 popularity score, on our list (the bar is 36)

↓ 9.3k/mo

GitHub stars	–	0 points
PyPI downloads, last month	9,300	26.9 points
Official server	Yes	8 points
Hosted by its vendor	Yes	5.1 points

Measured 2026-11-07. How the score works.

Where it is published

PyPI	klaviyo-mcp-server 0.4.2, 2026-10-19
Hosted	`https://mcp.klaviyo.com/mcp` Streamable HTTP · OAuth sign-in

What it can reach

Runs	On your machine, or on the maker's servers
Reaches	Your account at a service, The internet, Files on your machine, Sends messages
Changes things	Yes: it can write, send, create or delete
Sign-in	OAuth sign-in for the hosted endpoint; an API key or token to run it yourself
Licence	Not stated
Last code change	2026-10-19 (a release)

Reaches one Klaviyo account through Klaviyo's API. It writes: tools create campaigns, templates, events and profiles, update profiles and change marketing subscriptions; the hosted endpoint can also send and delete campaigns. The local package runs on your machine with a private API key whose scopes cap what it can do, and upload_image_from_file reads a local file you name. The hosted endpoint runs on Klaviyo's servers and signs in with OAuth as your Klaviyo user. Klaviyo warns that tools reading profile properties, events or reviews can pass injected instructions to the model; the local 0.4.1 marks get_profiles, get_profile, update_profile and get_events this way. Each local tool call reports the model family you pick and your client's name to Klaviyo in the User-Agent.

Over time

PyPI downloads a month 9.3k +7.0k (+298 %)

9.3k2.3k

13 May 20267 Nov 2026

Before the site measured it, read from pypistats' daily download counts.

Popularity score 40 +0

4040

13 May 20267 Nov 2026

Before the site measured it, read from those stars and downloads, by today's rule.

What is rising across the directory

Sources

Page checked 2026-10-15.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![Klaviyo MCP Server on EveryMCPServer](https://everymcpserver.com/badge/klaviyo-mcp-server.svg)](https://everymcpserver.com/servers/klaviyo-mcp-server)

Connect your client

Add in one click

Or add it by command or config

Add in one click

Or add it by command or config

Settings 3

What it does

What it needs

Limits

Who it suits

Tools 28

Similar servers

Braze MCP Server

Customer.io MCP

Databuddy MCP server

MCP Server for Odoo

OneSignal MCP Server

Optimizely Experimentation MCP Server