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.

    Full setup, and how to undo it

    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.