Klaviyo MCP

io.scalablyPublished by scalably.iov1.0.0Updated Oct 24, 2026

Klaviyo MCP: campaigns, flows, segments, metrics, reports, profiles across many accounts. 24 tools.

VerifiedSTDIODesktop onlyData & Analytics Business & Commerce

Server details

Identifier: io.scalably/klaviyo-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to scalably.io. It runs from a package rather than a hosted endpoint, so there is no endpoint to match against that domain.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.scalably%2Fklaviyo-mcp.svg)](https://sourceweft.com/mcp/io.scalably%2Fklaviyo-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local Klaviyo MCP server with 24 read-only tools for campaigns, flows, segments, metrics, reports and profiles across multiple accounts.

What you can do: List configured accounts and account metadata such as org name, timezone and currency
List and inspect campaigns, flows, segments, lists, tags and templates, including template HTML
Pull campaign, flow, segment and sign-up form performance reports, plus A/B variation breakdowns and time series
Aggregate any metric over a custom timeframe and run custom values or series reports
Look up customer profiles and recent events, and list suppressed profiles by reason
Produce a unified cross-brand summary across all configured accounts
When to use it: Useful when you want an assistant to answer questions about Klaviyo email and SMS marketing performance, compare brands or accounts, or audit campaigns, flows and templates without opening the Klaviyo dashboard.
Requirements: Runs locally via npx or the Claude Desktop .mcpb bundle. Needs a Klaviyo private API key in KLAVIYO_KEY_MAIN, or one KLAVIYO_KEY_ variable per account; multiple accounts require Claude Code or Codex. Optional KLAVIYO_API_BASE and KLAVIYO_RETRY_BASE_MS. Network access to the Klaviyo API.

Before you install

Requires a Klaviyo private API key, which grants access to your account data; keep it out of shared configs. Tools are read-only, but they expose customer profile details and marketing consent status. Reporting endpoints are rate limited to 2 requests per minute per account, and reporting data starts 2023-06-01 with ranges capped at one calendar year.

Installation

In SourceWeft

Open Klaviyo MCP in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Klaviyo MCP

Klaviyo MCP server. 24 read-only tools cover campaigns, flows, segments, metrics, reports, and profiles across many accounts.

Install

Claude Code:

Codex:

Claude Desktop: download klaviyo-mcp.mcpb from the latest GitHub release and open it. Claude Desktop's install form only accepts one account (KLAVIYO_KEY_MAIN).

Setup

Create a private API key in Klaviyo under Settings > API Keys.
Set one KLAVIYO_KEY_<name>=pk_xxx environment variable per account, for example KLAVIYO_KEY_MAIN or KLAVIYO_KEY_STOREONE. The server auto-discovers every KLAVIYO_KEY_* variable at startup; list_accounts shows what it found.
Multiple Klaviyo accounts (agencies, multi-brand portfolios) work only through Claude Code or Codex, since both let you pass arbitrary extra environment variables. Add as many KLAVIYO_KEY_<name> variables as you have accounts, then call tools with the matching account argument (the name after KLAVIYO_KEY_, lowercased).
All 24 tools are read-only.

Tools (24)

Tool	What it does
`list_accounts`	List all configured Klaviyo accounts. Use this first to see which brands are available.
`list_campaigns`	List recent email campaigns for a specific Klaviyo account. Returns campaign IDs, names, status, and send dates.
`campaign_report`	Get email campaign performance metrics for a Klaviyo account. Returns opens, clicks, revenue, bounce rate, unsubscribes for the specified time period.
`list_metrics`	List available metrics for a Klaviyo account. Use this to find the 'Placed Order' metric ID needed for revenue reporting.
`multi_account_summary`	Pull campaign performance summary from ALL configured Klaviyo accounts. Returns a unified cross-brand report.
`flow_report`	Get email flow (automation) performance for a Klaviyo account. Returns metrics for welcome series, abandoned cart, post-purchase, etc.
`campaign_ab_report`	Get per-variation (A/B arm) email/SMS campaign metrics for a Klaviyo account. Splits results by variation so you can compare arms.
`flow_series_report`	Time-series flow (automation) metrics for a Klaviyo account. Buckets by interval.
`segment_report`	Segment performance metrics for a Klaviyo account: member counts, additions, removals.
`form_report`	Sign-up form performance for a Klaviyo account: views, submissions, submit rate.
`list_segments`	List all segments in a Klaviyo account with name, member count, and creation date.
`list_lists`	List all email lists in a Klaviyo account with name, opt-in process, and creation date.
`list_flows`	List all flows (automations) in a Klaviyo account with name, status, trigger type, and last updated.
`get_campaign_detail`	Get full details for a single campaign by ID: name, status, send_time, subject, preview text, channel, and message IDs.
`list_suppressed_profiles`	List profiles suppressed from email marketing for a single reason. Klaviyo only allows `equals` (not `any`) for suppression.reason, so call once per reason for a full picture.
`metric_aggregate`	Aggregate values for any Klaviyo metric (e.g. opens, clicks, revenue) over a custom timeframe and interval.
`get_template`	Fetch an email template by ID, including HTML/text content. Use for audit/preview.
`list_recent_events`	List recent events for a Klaviyo account, optionally filtered by metric_id (e.g. Placed Order). Returns up to 100 most recent.
`account_info`	Get Klaviyo account metadata: org name, timezone, currency, contact email, industry.
`list_tags`	List all tags in a Klaviyo account (used to label campaigns, flows, segments, lists).
`list_templates`	List email templates in a Klaviyo account (name, editor type, dates). Use `get_template` for the HTML of one.
`get_profile`	Look up a customer profile by email or profile ID: name, location, and email-marketing consent/suppression status.
`get_flow_detail`	Get a flow's structure by ID: status, trigger, and its actions/steps (type, message channel). Use `list_flows` for IDs.
`custom_report`	Expert escape hatch: run any Klaviyo values or series report with full control over statistics, group_by, filter, interval, and timeframe.

Configuration

Variable	Required	Purpose
`KLAVIYO_KEY_MAIN` (or any `KLAVIYO_KEY_<name>`)	yes	Private API key for one Klaviyo account. One variable per account; the name after `KLAVIYO_KEY_` becomes the `account` argument.
`KLAVIYO_API_BASE`	no	Override the Klaviyo API base URL (default `https://a.klaviyo.com/api`)
`KLAVIYO_RETRY_BASE_MS`	no	Base delay in milliseconds for the retry backoff (default 1000)

Reply shape

Every tool returns plain JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures throw a plain error string: <code>: <message> <hint>.

Limits

Reporting endpoints (campaign_report, flow_report, campaign_ab_report, flow_series_report, segment_report, form_report, custom_report for values/series reports) are rate limited by Klaviyo to 2 requests per minute per account. Reporting data is only available from 2023-06-01 onward; a custom range starting earlier is clamped to that floor. A single reporting request cannot span more than one calendar year, so a longer custom range is auto-windowed into consecutive yearly chunks with a spacing delay between them.

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the packed tarball on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: [email protected]. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

Source: README.md at commit 48811d3

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts