Klaviyo MCP: campaigns, flows, segments, metrics, reports, profiles across many accounts. 24 tools.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for Klaviyo MCP, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
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_xxxenvironment variable per account, for exampleKLAVIYO_KEY_MAINorKLAVIYO_KEY_STOREONE. The server auto-discovers everyKLAVIYO_KEY_*variable at startup;list_accountsshows 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 matchingaccountargument (the name afterKLAVIYO_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: hello@scalably.io. Canonical copy: https://scalably.io/connector-privacy.html
License
MIT. Copyright Scalably.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Klaviyo MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/klaviyo-mcp)HTML Embed
<a href="https://allmcps.com/mcp/klaviyo-mcp"><img src="https://allmcps.com/api/badge/klaviyo-mcp?style=directory" alt="Klaviyo MCP on AllMCPs" /></a>