Klaviyo MCP Server
Connect AI agents to Klaviyo email & SMS marketing — campaigns, flows, segments, and reporting via MCP.
Updated
What is Klaviyo MCP?
The Klaviyo MCP server is a Model Context Protocol server that lets AI agents securely read and act on your Klaviyo email and SMS marketing data — campaigns, flows, segments, profiles, events, and performance reporting.
Klaviyo offers it in two forms. The recommended option is the official remote-hosted server at https://mcp.klaviyo.com/mcp, which connects over OAuth (with dynamic client registration) using Streamable HTTP — no local install required. There is also a local server, distributed as the klaviyo-mcp-server package and run with uvx, that authenticates with a Klaviyo private API key.
Once connected, an MCP client like Claude, Cursor, ChatGPT, or VS Code can answer questions and take actions against your account — for example summarizing recent campaign performance, comparing flow conversions, or drafting a new email campaign. The remote server exposes a broad tool set by default; query parameters such as read-only=true and core-tools-only=true let you restrict it to non-destructive or just the ~40 core tools.
Tools the Klaviyo MCP server exposes
| Tool | What it does |
|---|---|
| Campaigns | Read campaign performance and create or manage email and SMS campaigns. |
| Flows | Read automated flows and review flow performance and conversions. |
| Segments | Read and build audience segments from profile and event data. |
| Lists | Read marketing lists and their membership. |
| Profiles | Read and update customer profiles in your account. |
| Events / Metrics | Read events and metric aggregates to analyze customer behavior and performance. |
| Templates | Read and manage email and message templates. |
| Catalogs | Read product catalog data used for personalization. |
| Subscriptions | Manage email and SMS subscription and consent state for profiles. |
| Reporting | Generate performance reports across campaigns and flows for a given time range. |
Connect the Klaviyo MCP server
Claude (remote, OAuth)
- 1
Open connector settings
In Claude, go to Settings > Connectors. Use the listed Klaviyo connector for a single account, or click Add custom connector for multiple accounts.
- 2
Add the Klaviyo server
For a custom connector, set Name to Klaviyo and Remote MCP server URL to https://mcp.klaviyo.com/mcp. Optionally append query params like ?read-only=true or ?core-tools-only=true.
- 3
Authenticate with OAuth
Click Connect, approve Claude access, then review and Allow permissions for your Klaviyo account (you need an Owner, Admin, or Manager role).
- 4
Test it
Start a chat and ask, e.g., "Show me my email campaign performance for the last 30 days."
Recommended: the official remote-hosted Klaviyo server over OAuth.
Cursor (remote, OAuth)
- 1
Open MCP settings
In Cursor, go to Settings > Cursor Settings > MCP > New MCP Server.
- 2
Add the server config
Add: { "mcpServers": { "klaviyo": { "url": "https://mcp.klaviyo.com/mcp" } } } and save. Append query params to the URL to control behavior if desired.
- 3
Log in
Go to Settings > Cursor Settings > Tools & Integrations, click Needs login next to klaviyo, and complete the OAuth authentication.
- 4
Verify
Check for the connected indicator and ask a test question about your Klaviyo data.
Security & permissions
The remote server authenticates with OAuth (dynamic client registration); the agent acts on behalf of the authorizing Klaviyo user and is limited to Klaviyo accounts where that user has an Owner, Admin, or Manager role. The local server instead uses a private API key whose scopes you set per data domain (e.g. Campaigns, Flows, Profiles, Segments). Add read-only=true to disable all write tools, and disable-tools-with-user-generated-content=true to block tools that surface user-generated content (which could carry prompt-injection instructions). Review each write tool call before approving it.
Using Klaviyo MCP with Gamut
In a Gamut workflow, Klaviyo becomes a connected tool that an agent can call on a schedule or in response to an event — Gamut manages the OAuth connection to the remote server so the agent can authenticate without manual key handling. For example, a scheduled agent can pull the last 30 days of campaign and flow performance and post a digest to Slack, or an event-triggered run can build a segment and queue a campaign for human review. Use the read-only=true parameter when the workflow only needs to report, and reserve write-capable runs for steps where the agent should create or modify Klaviyo content.
Frequently asked questions
What is the Klaviyo MCP server?
It is an official Model Context Protocol server from Klaviyo that lets AI agents like Claude, Cursor, and ChatGPT interact with your Klaviyo email and SMS marketing data — campaigns, flows, segments, profiles, events, and reporting — through a standard interface.
Is the Klaviyo MCP server free?
Yes. There is no separate charge for the MCP server beyond your existing Klaviyo account; standard plan limits and API usage apply. The recommended remote-hosted server requires a Klaviyo user with an Owner, Admin, or Manager role.
How do I connect the Klaviyo MCP server to Claude or Cursor?
Use the remote server URL https://mcp.klaviyo.com/mcp. In Claude, add it as a connector (or use the listed Klaviyo connector) and authorize via OAuth. In Cursor, add it under Settings > MCP as a new server with that URL, then click Needs login to complete OAuth.
Is the Klaviyo MCP server hosted or self-hosted?
Both. Klaviyo recommends its official remote-hosted server at https://mcp.klaviyo.com/mcp (OAuth, no install). It also offers a local server you run yourself with uvx (the klaviyo-mcp-server package), authenticated with a private Klaviyo API key.