Access your Klaviyo marketing data — campaigns, flows, profiles, segments, metrics, and performance reports — all through natural language in Claude Code.
Overview
The Klaviyo integration lets you query your email and SMS marketing data directly from Claude Code. Instead of navigating the Klaviyo dashboard, building custom reports, or exporting data manually, you can ask questions in natural language and get instant answers about your campaigns, automation flows, customer profiles, segments, and performance metrics.
Presso connects to the Klaviyo API, giving you access to campaigns, flows, profiles, segments, lists, metrics, events, catalog items, templates, tags, and detailed performance reports.
Setup
Prerequisites
A Klaviyo account with an active plan
Account access with at least Analyst permissions
A Presso account connected to Claude Code (see MCP Connection)
Connecting your Klaviyo account
Sign in to Presso and navigate to the Integrations page.
Click Connect next to Klaviyo.
You will be redirected to Klaviyo's OAuth consent screen. Sign in and authorize Presso to access your account data.
Once authorized, you will be redirected back to Presso. Your Klaviyo account is now connected.
In Claude Code, verify the connection by asking:
Show me my recent Klaviyo campaigns and their performance.
Available tools
Presso exposes your Klaviyo data through a comprehensive set of tools organized by category.
Account
Tool
Description
klaviyo_get_account
Get account information including contact info, timezone, and currency
Campaigns
Tool
Description
klaviyo_list_campaigns
List campaigns with filtering by channel (email/SMS) and status (draft, scheduled, sent)
klaviyo_get_campaign
Get detailed information about a specific campaign including messages and tags
klaviyo_query_campaign_report
Get campaign performance report with opens, clicks, conversions, and revenue
Flows
Tool
Description
klaviyo_list_flows
List automation flows with optional status filter (draft, manual, live)
klaviyo_get_flow
Get detailed information about a specific flow including its actions and tags
klaviyo_query_flow_report
Get flow performance report with opens, clicks, conversions, and revenue
Profiles
Tool
Description
klaviyo_list_profiles
List and search customer profiles with filtering and sorting
klaviyo_get_profile
Get detailed profile information with optional predictive analytics (CLV, churn probability)
Segments and lists
Tool
Description
klaviyo_list_segments
List all audience segments
klaviyo_get_segment
Get detailed segment information including profile count
klaviyo_get_segment_profiles
Get profiles belonging to a specific segment
klaviyo_list_lists
List all subscriber lists
klaviyo_get_list
Get detailed information about a specific list
Metrics and events
Tool
Description
klaviyo_list_metrics
List all available metrics (event types) in your account
klaviyo_query_metric_aggregates
Query aggregated metric data for analytics with grouping and time intervals
klaviyo_list_events
List events (customer actions) with filtering by metric or profile
Catalog
Tool
Description
klaviyo_list_catalog_items
List catalog items (products synced from your store)
Templates and tags
Tool
Description
klaviyo_list_templates
List email and SMS templates
klaviyo_list_tags
List all tags used for organizing campaigns, flows, lists, and segments
Example queries
Campaign performance
Show me all sent email campaigns from the last 30 days with their open rates and click rates.
What's the revenue generated by my top 5 campaigns this month?
Compare the performance of my last 3 email campaigns -- which one had the best click-through rate?
Flow analysis
List all my live automation flows and their performance metrics.
How is my welcome series flow performing? Show me open rate, click rate, and revenue.
Which flow generates the most revenue?
Customer insights
How many total profiles do I have in Klaviyo?
Show me the predictive CLV and churn probability for my top customers.
Find the profile for customer@example.com and show me their event history.
Segment analysis
List all my segments with their profile counts.
How many people are in my "VIP Customers" segment?
Show me the profiles in my "At Risk" segment.
Metric analytics
Show me the total number of placed orders over the last 90 days, grouped by month.
What's the trend for email opens over the last 30 days?
Break down revenue by campaign for this quarter.
List management
List all my subscriber lists and their sizes.
How many subscribers are in my main newsletter list?
Performance reports
Presso provides detailed performance reports for both campaigns and flows. These reports include key metrics that help you understand the effectiveness of your marketing efforts.
Available report metrics
Metric
Description
recipients
Number of recipients who received the message
opens
Total number of opens
open_rate
Percentage of recipients who opened
clicks
Total number of clicks
click_rate
Percentage of recipients who clicked
conversions
Number of conversion events
conversion_value
Total revenue from conversions
revenue_per_recipient
Average revenue per recipient
unsubscribe_rate
Percentage of recipients who unsubscribed (campaigns only)
bounce_rate
Percentage of bounced messages (campaigns only)
Report timeframes
You can specify timeframes naturally:
Natural language
Interpreted as
"last 7 days"
Past 7 days from today
"last 30 days"
Past 30 days from today
"last 90 days"
Past 90 days from today
"this year"
January 1 of current year to today
"last year"
Full previous calendar year
Predictive analytics
Klaviyo provides predictive analytics for customer profiles. When querying profile data, you can request predictive metrics:
Predicted CLV (Customer Lifetime Value) -- Estimated total revenue a customer will generate
Churn probability -- Likelihood that a customer will not make another purchase
Show me customers with the highest predicted CLV in my "Active Buyers" segment.
Which customers have a churn probability above 50%? Show me their recent activity.
Combining with other integrations
Combine Klaviyo data with other connected platforms for deeper insights:
Compare Klaviyo email campaign revenue with Shopify order data --
are there discrepancies in attribution?
Show me GA4 traffic from email campaigns alongside Klaviyo's reported click data.
Cross-reference my Klaviyo "High Value" segment with Shopify customer spending data.
Limitations and notes
Read-only access -- Presso provides read-only access to your Klaviyo data. You cannot create campaigns, modify flows, or change account settings through Presso.
API rate limits -- Klaviyo's API has rate limits. Normal usage is well within these limits, but very intensive analysis sessions may approach them.
Predictive analytics availability -- Predictive CLV and churn probability require sufficient historical data in your Klaviyo account. These metrics may not be available for all profiles.
Conversion tracking -- Campaign and flow reports require a conversion metric ID (typically the "Placed Order" metric) to show conversion and revenue data. Presso handles this automatically.
Data freshness -- Klaviyo data is queried in real time. Campaign and flow reports reflect the latest available data from Klaviyo's reporting system.
SMS data -- SMS campaign data is available if you have Klaviyo's SMS feature enabled on your account.
Catalog sync -- Catalog items reflect products synced from your connected e-commerce platform (e.g., Shopify). Ensure your catalog sync is active for up-to-date product data.
