Skip to content
API Reference
Klaviyo logo

Klaviyo

Marketing

AI-powered email and SMS marketing automation

Manage customer profiles, subscriptions, lists, segments, catalog items, campaigns, flows, email templates, and analytics through the Klaviyo MCP server for B2C marketing automation across email, SMS, and push notifications.

Adding Klaviyo provisions three things in your zone: an upstream resource pointing at https://mcp.klaviyo.com/mcp (kept inside Keycard), a Keycard MCP Gateway URL - the downstream resource - that you install in Cursor, Claude Code, or any MCP client, and a provider for token exchange with Klaviyo’s OAuth issuer.

When your AI client makes a tool call, it sends a Keycard-issued access token to the gateway URL. Keycard’s STS exchanges that token for an upstream Klaviyo token, the gateway calls the upstream MCP, and the response is proxied back. Your zone’s identity provider, access policies, and audit log apply to every call - the upstream credential never leaves Keycard. Each call is recorded in the audit log with the user identity, the resource accessed, and the policy decision.

Tools the upstream server exposes through the Keycard MCP Gateway.

Klaviyo exposes 27 tools through the gateway:

get_account_details
Get account details
get_profiles
Get all profiles in an account
get_profile
Get a profile by ID, including subscription information
create_profile
Create a profile (requires email, phone_number, or external_id)
update_profile
Update a profile by ID
subscribe_profile_to_marketing
Subscribe a profile to marketing channels; creates the profile if it does not exist
unsubscribe_profile_from_marketing
Unsubscribe a profile from marketing channels
get_lists
Get all lists in an account
get_list
Get a list by ID
get_segments
Get all segments in an account
get_segment
Get a segment by ID
get_events
Get individual event records for a filter (profile, metric, etc.); use reports or aggregates for performance data
get_metrics
Get all metrics in an account
get_metric
Get a metric by ID
query_metric_aggregates
Aggregate event data for a metric with optional grouping (event-time semantics; use campaign/flow reports for UI-aligned send-date performance)
get_catalog_items
Get catalog items (products) in an account
get_campaigns
List campaigns with filters (not for status or performance reporting)
get_campaign
Get a campaign by ID
create_campaign
Create a draft campaign
get_campaign_report
Campaign performance metrics (opens, clicks, conversions) with audience, send channel, and timing metadata
get_flows
List flows with filters (not for status or performance reporting)
get_flow
Get a flow by ID
get_flow_report
Flow performance metrics (opens, clicks, conversions) with flow and trigger metadata
create_email_template
Create an email template from HTML
get_email_template
Get an email template by ID (includes HTML or AMP)
assign_template_to_campaign_message
Assign an email template to a campaign message
upload_image_from_url
Upload an image from a URL or data URI

Add Klaviyo to your zone and install the gateway URL into Cursor, Claude Code, or any MCP client.

  1. Open the catalog

    In your zone’s Keycard Console, go to ApplicationsAdd ApplicationExplore MCP Servers.

  2. Find and install Klaviyo

    Search for Klaviyo in the catalog and click Install.

  3. Connect your development tool

    Once installed, Klaviyo appears on the Applications page with a Keycard MCP Gateway URL. Use the Install dropdown to add it to Cursor, Claude Code, or any MCP-compatible client.