Klaviyo MCP

io.scalably由 scalably.io 发布v1.0.0更新于 Oct 24, 2026

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

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

本地运行的 Klaviyo MCP 服务器，提供 24 个只读工具，覆盖多账号的营销活动、流程、分群、指标、报告和客户档案。

可以做什么
  • 列出已配置的账号及组织名称、时区、货币等账号信息
  • 列出并查看营销活动、流程、分群、列表、标签和模板，包括模板 HTML 内容
  • 获取营销活动、流程、分群和注册表单的效果报告，以及 A/B 变体对比和时间序列数据
  • 按自定义时间范围聚合任意指标，并运行自定义 values 或 series 报告
  • 查询客户档案和近期事件，按原因列出被抑制的档案
  • 汇总所有已配置账号，生成跨品牌统一报告
适用场景
适合让助手回答 Klaviyo 邮件与短信营销效果问题、比较不同品牌或账号，或在不打开 Klaviyo 后台的情况下审查营销活动、流程和模板。
运行要求
通过 npx 或 Claude Desktop 的 .mcpb 包在本地运行。需要 Klaviyo 私有 API 密钥，放在 KLAVIYO_KEY_MAIN 中；多账号则每个账号一个 KLAVIYO_KEY_ 变量，且仅 Claude Code 或 Codex 支持多账号。可选 KLAVIYO_API_BASE 和 KLAVIYO_RETRY_BASE_MS。需能访问 Klaviyo API。
安装前请注意
需要 Klaviyo 私有 API 密钥，该密钥可访问账号数据，请勿写入共享配置。工具均为只读，但会暴露客户档案信息和邮件营销同意状态。报告接口每账号每分钟限 2 次请求，报告数据仅从 2023-06-01 起可用，单次范围不超过一个自然年。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Klaviyo MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Klaviyo MCP

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

Install

Claude Code:

bash
claude mcp add klaviyo -e KLAVIYO_KEY_MAIN=pk_your_key -- npx -y @scalably-io/klaviyo-mcp

Codex:

bash
codex mcp add klaviyo --env KLAVIYO_KEY_MAIN=pk_your_key -- npx -y @scalably-io/klaviyo-mcp

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

  1. Create a private API key in Klaviyo under Settings > API Keys.
  2. 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.
  3. 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).
  4. All 24 tools are read-only.

Tools (24)

ToolWhat it does
list_accountsList all configured Klaviyo accounts. Use this first to see which brands are available.
list_campaignsList recent email campaigns for a specific Klaviyo account. Returns campaign IDs, names, status, and send dates.
campaign_reportGet email campaign performance metrics for a Klaviyo account. Returns opens, clicks, revenue, bounce rate, unsubscribes for the specified time period.
list_metricsList available metrics for a Klaviyo account. Use this to find the 'Placed Order' metric ID needed for revenue reporting.
multi_account_summaryPull campaign performance summary from ALL configured Klaviyo accounts. Returns a unified cross-brand report.
flow_reportGet email flow (automation) performance for a Klaviyo account. Returns metrics for welcome series, abandoned cart, post-purchase, etc.
campaign_ab_reportGet per-variation (A/B arm) email/SMS campaign metrics for a Klaviyo account. Splits results by variation so you can compare arms.
flow_series_reportTime-series flow (automation) metrics for a Klaviyo account. Buckets by interval.
segment_reportSegment performance metrics for a Klaviyo account: member counts, additions, removals.
form_reportSign-up form performance for a Klaviyo account: views, submissions, submit rate.
list_segmentsList all segments in a Klaviyo account with name, member count, and creation date.
list_listsList all email lists in a Klaviyo account with name, opt-in process, and creation date.
list_flowsList all flows (automations) in a Klaviyo account with name, status, trigger type, and last updated.
get_campaign_detailGet full details for a single campaign by ID: name, status, send_time, subject, preview text, channel, and message IDs.
list_suppressed_profilesList 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_aggregateAggregate values for any Klaviyo metric (e.g. opens, clicks, revenue) over a custom timeframe and interval.
get_templateFetch an email template by ID, including HTML/text content. Use for audit/preview.
list_recent_eventsList recent events for a Klaviyo account, optionally filtered by metric_id (e.g. Placed Order). Returns up to 100 most recent.
account_infoGet Klaviyo account metadata: org name, timezone, currency, contact email, industry.
list_tagsList all tags in a Klaviyo account (used to label campaigns, flows, segments, lists).
list_templatesList email templates in a Klaviyo account (name, editor type, dates). Use get_template for the HTML of one.
get_profileLook up a customer profile by email or profile ID: name, location, and email-marketing consent/suppression status.
get_flow_detailGet a flow's structure by ID: status, trigger, and its actions/steps (type, message channel). Use list_flows for IDs.
custom_reportExpert escape hatch: run any Klaviyo values or series report with full control over statistics, group_by, filter, interval, and timeframe.

Configuration

VariableRequiredPurpose
KLAVIYO_KEY_MAIN (or any KLAVIYO_KEY_<name>)yesPrivate API key for one Klaviyo account. One variable per account; the name after KLAVIYO_KEY_ becomes the account argument.
KLAVIYO_API_BASEnoOverride the Klaviyo API base URL (default https://a.klaviyo.com/api)
KLAVIYO_RETRY_BASE_MSnoBase 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.

来源：README.md，提交 48811d3

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分