# Klaviyo MCP (npm · @scalably-io/klaviyo-mcp)

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

- Trust score: 75/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- mcpb · `klaviyo-mcp.mcpb`: 53/100, [markdown](https://verifymcp.io/servers/io-scalably-klaviyo-mcp/https-github-com-scalably-io-klaviyo-mcp-releases-download-v1-0-0-klaviyo-mcp-mc.md), [page](https://verifymcp.io/servers/io-scalably-klaviyo-mcp/https-github-com-scalably-io-klaviyo-mcp-releases-download-v1-0-0-klaviyo-mcp-mc)
- npm · `@scalably-io/klaviyo-mcp`: 75/100 (this document), [markdown](https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp.md), [page](https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp)

## Channel facts

- Registry: `npm`
- Package: `@scalably-io/klaviyo-mcp`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 71 of 191 dependencies flagged as unhealthy (2 deprecated).
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 11 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2666 tokens (~111/item across 24 items; 24 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 37/100
  - Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 95% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 24 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 24 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Klaviyo MCP server?

Klaviyo MCP runs locally as an npm package, launched with npx -y @scalably-io/klaviyo-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add io-scalably-klaviyo-mcp -- npx -y @scalably-io/klaviyo-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "io-scalably-klaviyo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@scalably-io/klaviyo-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-scalably-klaviyo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@scalably-io/klaviyo-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add io-scalably-klaviyo-mcp -- npx -y @scalably-io/klaviyo-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-scalably-klaviyo-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@scalably-io/klaviyo-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-scalably-klaviyo-mcp --command npx --arg -y --arg @scalably-io/klaviyo-mcp
```

### Hermes

```yaml
mcp_servers:
  io-scalably-klaviyo-mcp:
    command: "npx"
    args: ["-y", "@scalably-io/klaviyo-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "io-scalably-klaviyo-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@scalably-io/klaviyo-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-scalably-klaviyo-mcp -t stdio -c npx -a -y @scalably-io/klaviyo-mcp
```

### Other

```json
{
  "mcpServers": {
    "io-scalably-klaviyo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@scalably-io/klaviyo-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-19 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-16 (score 73, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-09-09 (score 70)

First indexed and scored.

## MCP tools (24)

### `list_accounts` (~26 tokens)

List all configured Klaviyo accounts. Use this first to see which brands are available.

### `list_campaigns` (~76 tokens)

List recent email campaigns for a specific Klaviyo account. Returns campaign IDs, names, status, and send dates.

Input parameters:

- `account` (string, required): Account name (e.g., 'my-store' or 'My Store')
- `status` (string): Filter by campaign status (case-sensitive Klaviyo values). Default: all.

### `campaign_report` (~203 tokens)

Get email campaign performance metrics for a Klaviyo account. Returns opens, clicks, revenue, bounce rate, unsubscribes for the specified time period. Rate limited: 2/min.

Input parameters:

- `account` (string, required): Account name
- `conversion_metric_id` (string, required): Metric ID for revenue tracking (Placed Order). REQUIRED by Klaviyo API. Get from list_metrics tool first.
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string): Preset period. Default: last_30_days. Ignored if a custom range is given.
- `year` (integer): Year for quarter, e.g. 2024.

### `list_metrics` (~43 tokens)

List available metrics for a Klaviyo account. Use this to find the 'Placed Order' metric ID needed for revenue reporting.

Input parameters:

- `account` (string, required): Account name

### `multi_account_summary` (~227 tokens)

Pull campaign performance summary from ALL configured Klaviyo accounts. Returns a unified cross-brand report. Rate limited: 2/min per account - may take several minutes for many accounts.

Input parameters:

- `conversion_metric_ids` (object): Map of account name → Placed Order metric ID (from the klaviyo skill table). STRONGLY recommended: accounts often have duplicate "Placed Order" metrics and auto-discovery can pick the wrong one (reve…
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string): Preset period. Default: last_30_days. Ignored if a custom range is given.
- `year` (integer): Year for quarter, e.g. 2024.

### `flow_report` (~189 tokens)

Get email flow (automation) performance for a Klaviyo account. Returns metrics for welcome series, abandoned cart, post-purchase, etc.

Input parameters:

- `account` (string, required): Account name
- `conversion_metric_id` (string, required): Metric ID for revenue tracking (Placed Order). REQUIRED. Get from list_metrics tool first.
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string): Preset period. Default: last_30_days. Ignored if a custom range is given.
- `year` (integer): Year for quarter, e.g. 2024.

### `campaign_ab_report` (~188 tokens)

Get per-variation (A/B arm) email/SMS campaign metrics for a Klaviyo account. Splits results by variation so you can compare arms. Rate limited: 2/min.

Input parameters:

- `account` (string, required): Account name
- `campaign_id` (string): Filter to a single campaign ID.
- `conversion_metric_id` (string, required): Placed Order metric ID. Get from list_metrics.
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string)
- `year` (integer): Year for quarter, e.g. 2024.

### `flow_series_report` (~163 tokens)

Time-series flow (automation) metrics for a Klaviyo account. Buckets by interval. Rate limited: 2/min.

Input parameters:

- `account` (string, required): Account name
- `conversion_metric_id` (string, required): Placed Order metric ID.
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `interval` (string)
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string)
- `year` (integer): Year for quarter, e.g. 2024.

### `segment_report` (~140 tokens)

Segment performance metrics for a Klaviyo account: member counts, additions, removals. Rate limited: 2/min.

Input parameters:

- `account` (string, required): Account name
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string)
- `year` (integer): Year for quarter, e.g. 2024.

### `form_report` (~140 tokens)

Sign-up form performance for a Klaviyo account: views, submissions, submit rate. Rate limited: 2/min.

Input parameters:

- `account` (string, required): Account name
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `timeframe` (string)
- `year` (integer): Year for quarter, e.g. 2024.

### `list_segments` (~36 tokens)

List all segments in a Klaviyo account with name, member count, and creation date.

Input parameters:

- `account` (string, required): Account name

### `list_lists` (~38 tokens)

List all email lists in a Klaviyo account with name, opt-in process, and creation date.

Input parameters:

- `account` (string, required): Account name

### `list_flows` (~53 tokens)

List all flows (automations) in a Klaviyo account with name, status, trigger type, and last updated.

Input parameters:

- `account` (string, required): Account name
- `status` (string): Filter by status.

### `get_campaign_detail` (~56 tokens)

Get full details for a single campaign by ID: name, status, send_time, subject, preview text, channel, and message IDs.

Input parameters:

- `account` (string, required): Account name
- `campaign_id` (string, required): Campaign ID.

### `list_suppressed_profiles` (~106 tokens)

List profiles suppressed from email marketing for a single reason. Klaviyo only allows `equals` (not `any`) for suppression.reason, so call once per reason if you need a full picture. Up to 100 per call. Use cursor for pagination.

Input parameters:

- `account` (string, required): Account name
- `page_cursor` (string): Cursor from previous page.
- `reason` (string, required): Suppression reason. Required - Klaviyo allows only `equals` here.

### `metric_aggregate` (~192 tokens)

Aggregate values for any Klaviyo metric (e.g. opens, clicks, revenue) over a custom timeframe + interval. More flexible than campaign/flow reports - use for any metric.

Input parameters:

- `account` (string, required): Account name
- `end` (string): Custom end YYYY-MM-DD. Defaults to now.
- `interval` (string): Note: metric-aggregates uses singular (hour/day/week/month), NOT the series-report plural form.
- `measurement` (string): count, sum_value (revenue), or unique. Default count.
- `metric_id` (string, required): Metric ID. Get from list_metrics.
- `start` (string): Custom start YYYY-MM-DD. Raw events have NO 2023 floor - reaches back to account inception. Max 1 year per call.
- `timeframe` (string): Preset lookback. Use this OR start/end. Default: last_30_days.

### `get_template` (~63 tokens)

Fetch an email template by ID, including HTML/text content. Use for audit/preview.

Input parameters:

- `account` (string, required): Account name
- `include_html` (boolean): Include full HTML body. Default false (truncated).
- `template_id` (string, required): Template ID.

### `list_recent_events` (~93 tokens)

List recent events for a Klaviyo account, optionally filtered by metric_id (e.g. Placed Order). Returns up to 100 most recent.

Input parameters:

- `account` (string, required): Account name
- `metric_id` (string): Filter to events for one metric.
- `page_cursor` (string): Cursor from the previous page.
- `page_size` (integer): Default 25, maximum 100 per page.

### `account_info` (~36 tokens)

Get Klaviyo account metadata: org name, timezone, currency, contact email, industry.

Input parameters:

- `account` (string, required): Account name

### `list_tags` (~38 tokens)

List all tags in a Klaviyo account (used to label campaigns, flows, segments, lists).

Input parameters:

- `account` (string, required): Account name

### `list_templates` (~43 tokens)

List email templates in a Klaviyo account (name, editor type, dates). Use get_template for the HTML of one.

Input parameters:

- `account` (string, required): Account name

### `get_profile` (~68 tokens)

Look up a customer profile by email or profile ID: name, location, and email-marketing consent/suppression status.

Input parameters:

- `account` (string, required): Account name
- `email` (string): Email address to look up.
- `profile_id` (string): Profile ID (alternative to email).

### `get_flow_detail` (~58 tokens)

Get a flow's structure by ID: status, trigger, and its actions/steps (type, message channel). Use list_flows for IDs.

Input parameters:

- `account` (string, required): Account name
- `flow_id` (string, required): Flow ID.

### `custom_report` (~391 tokens)

Expert escape hatch - run ANY Klaviyo values or series report with full control over statistics, group_by, filter, interval, and timeframe (preset OR custom range, auto-windowed into 1-year chunks back to the 2023-06-01 floor). Returns raw JSON results so you can analyze like a Klaviyo analyst. Use when the specialized report tools do not expose a statistic, dimension, or filter you need.

Input parameters:

- `account` (string, required): Account name
- `conversion_metric_id` (string): Required whenever you request a revenue/conversion statistic (e.g. conversion_value, conversion_rate).
- `end` (string): Custom range end, YYYY-MM-DD. Defaults to today.
- `filter` (string): Raw Klaviyo filter expression, e.g. equals(campaign_id,"01ABC"). You own its correctness.
- `group_by` (array): Grouping dimensions, e.g. ["campaign_id","send_channel"].
- `interval` (string): For *-series-report only: hourly/daily/weekly/monthly. Default daily.
- `quarter` (integer): Quarter 1-4 (with year) - convenience for a full quarter.
- `report_type` (string, required): Which Klaviyo report to run. NOTE: there is no campaign-series-report - campaign reports are values-only; use metric_aggregate or per-period campaign-values for campaign trends.
- `start` (string): Custom range start, YYYY-MM-DD. Overrides timeframe. Data floor: 2023-06-01 (earlier is clamped).
- `statistics` (array, required): Statistics to fetch, e.g. ["recipients","open_rate","conversion_value"]. Must be valid for the chosen report_type.
- `timeframe` (string): Preset period, OR use start/end/quarter/year.
- `year` (integer): Year for quarter, e.g. 2024.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp#diagnostics

## Score history

- 2026-09-20: 75
- 2026-09-19: 75
- 2026-09-18: 74
- 2026-09-17: 74
- 2026-09-16: 73
- 2026-09-15: 70
- 2026-09-14: 70
- 2026-09-13: 70
- 2026-09-12: 70
- 2026-09-11: 70
- 2026-09-10: 70
- 2026-09-09: 70

## Common questions

### What is the Klaviyo MCP server?

Klaviyo MCP is listed in the public MCP registry as io.scalably/klaviyo-mcp. Klaviyo MCP: campaigns, flows, segments, metrics, reports, profiles across many accounts. 24 tools. This page covers its npm package (@scalably-io/klaviyo-mcp).

### Is the Klaviyo MCP server safe to use?

Klaviyo MCP scores 75 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Klaviyo MCP server expose?

Klaviyo MCP exposes 24 tools: list_accounts, list_campaigns, campaign_report, list_metrics, multi_account_summary, and 19 more. Their descriptions and schemas cost roughly 2,666 tokens of context every time the server is loaded.

### Is the Klaviyo MCP server still maintained?

Klaviyo MCP is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Klaviyo MCP server under?

Klaviyo MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@scalably-io/klaviyo-mcp
- Socket report: https://socket.dev/npm/package/@scalably-io/klaviyo-mcp
- Repository: https://github.com/scalably-io/klaviyo-mcp
- Website: https://scalably.io/mcp/klaviyo-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp.json
- HTML version of this page: https://verifymcp.io/servers/io-scalably-klaviyo-mcp/scalably-io-klaviyo-mcp