Klaviyo MCP

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.

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)