integrations tools klaviyo
Klaviyo MCP for your AI agent
Cogny's Klaviyo integration exposes 34 tools (19 read, 11 write, 4 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 19readonly reads data.
- 11writecreates or changes something.
- 4destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect Klaviyo in Cogny. Every Klaviyo tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Notes
Klaviyo connects with a private API key. Cogny can create a campaign, give it its content (an HTML template), set its audience and send time, and then send or schedule it. Cogny's agent sends only after you confirm. A scheduled send can be reverted to a draft or cancelled; an email that has already gone out can't be recalled.
To send from Cogny, the key needs campaigns:write (create, update, send, schedule and cancel campaigns) and templates:write (create templates). A full-access key has both.
Klaviyo sends only to profiles with marketing consent, and an email campaign needs a template before it can be sent.
Known gaps
- Templates are created from HTML; Klaviyo's drag-and-drop editor can't be driven from Cogny.
- A cancelled campaign stays cancelled. To send it again, duplicate it in Klaviyo.
what each tool does.
Read 19 · only reads data
list_profilesReadList profiles with optional filter/sort.get_profileReadGet a profile by ID.list_listsReadList static lists.get_listReadGet a list by ID.get_list_profilesReadGet profiles in a list.list_segmentsReadList dynamic segments.get_segmentReadGet a segment by ID.list_campaignsReadList campaigns.get_campaignReadGet a campaign by ID.get_campaign_messageReadGet a campaign message by ID — returns subject line, preview text, sender, and content.get_campaign_send_jobReadCheck a campaign send: queued, processing, complete or cancelled.get_campaign_values_reportReadFetch per-campaign performance statistics (open/click/conversion/revenue).list_flowsReadList automated flows.get_flowReadGet a flow by ID.list_metricsReadList metrics (e.g. 'Placed Order').get_metricReadGet a metric by ID.list_eventsReadList events.list_templatesReadList email templates.get_accountReadGet account info (contact info, industry, timezone, locale, public API key).
Write 11 · creates or changes something
create_profileWriteCreate a profile.update_profileWritePatch a profile by ID.create_segmentWriteCreate a dynamic segment.update_segmentWriteUpdate a segment's name and/or definition.subscribe_profilesWriteSubscribe profiles to a list with consent.create_campaignWriteCreate a campaign.update_campaignWriteUpdate a draft campaign's name, audiences, send time, tracking or send options.assign_campaign_templateWriteSet the content of an email campaign message from a template.update_flow_statusWriteUpdate a flow's status (e.g. flip a draft flow live, or pause a live flow).create_eventWriteTrack a custom event against a profile.create_templateWriteCreate an HTML email template, to use as a campaign's content.
Destructive 4 · deletes, removes or replaces something
delete_segmentDestructiveDelete a segment by ID. This cannot be undone.unsubscribe_profilesDestructiveUnsubscribe profiles from a list.send_campaignDestructiveSend a campaign to its real recipients, or schedule it; use only after the user confirms.cancel_campaign_sendDestructiveStop a scheduled or sending campaign: revert it to draft, or cancel it for good.
Exact input schemas come from tools/list once Klaviyo is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.