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 分