Email marketing · 1 skill

Klaviyo MCP: connect it to Claude Code, plus ready-made skills

Pull campaign and flow performance, revenue per recipient, list growth and unsubscribes from Klaviyo, and post a weekly email and SMS report.

How to connect Klaviyo MCP to Claude Code, Codex or Cursor

Klaviyo MCP server, Klaviyo's official server. Klaviyo recommends the hosted one at https://mcp.klaviyo.com/mcp, which signs in with OAuth; it also runs locally with uvx klaviyo-mcp-server@latest and a private key in PRIVATE_API_KEY. In Claude Code, run claude mcp add --transport http klaviyo "https://mcp.klaviyo.com/mcp?read-only=true"; Cursor and Codex take the same URL in their MCP config. Its reporting tools are get_campaign_report and get_flow_report, alongside tools for campaigns, flows, lists, segments, profiles and templates (docs).
API with a private key. Create a private API key in Klaviyo's account settings with read-only access to Campaigns, Flows and Metrics, store it in KLAVIYO_API_KEY, and send Authorization: Klaviyo-API-Key <key>.

read-only=true on the MCP URL (or READ_ONLY=true locally) disables every tool that can write to your account, and disable-tools-with-user-generated-content=true keeps subscriber-written content out of the agent's context.

1 Klaviyo skill

Klaviyo weekly campaign report

Every Monday: last week's Klaviyo email campaigns with open and click rates and placed-order revenue, against the week before.

MarketingMondays at 8:00Report card

What agents do with Klaviyo

Klaviyo's Reporting API returns the numbers its dashboard shows. POST /api/campaign-values-reports/ and POST /api/flow-values-reports/ take a timeframe, a conversion_metric_id (usually Placed Order) and a list of statistics such as recipients, open_rate, click_rate, conversion_rate, conversion_value, revenue_per_recipient, unsubscribe_rate and bounce_rate, grouped by campaign or flow message and channel. GET /api/campaigns requires a filter on messages.channel (email or SMS) and returns names, status and send times, GET /api/metrics finds metric IDs, and POST /api/metric-aggregates/ counts events such as Subscribed to List over time. Requests go to https://a.klaviyo.com with a revision header that pins the API version.

Ecommerce and lifecycle marketers schedule a weekly campaign report ranked by revenue per recipient, flow performance for welcome, abandoned cart and post-purchase series, list growth against unsubscribes and spam complaints, and campaigns with unusually low open or click rates.

klaviyo.com

Teams that use these

Your Klaviyo numbers, on one board with everything else

Skills are free to use with any agent. Briefkin is where their results land: one board for every report, number and question your agents send, with a ping when something needs you.

Join the open beta See a live demo board

Free during the open beta. No card.