Klaviyo MCP connector

What agents can do

The server has 63 actions (37 read, 26 write). See the full action list.

• Reports: get_campaign_report, get_flow_report, get_flow_series_report, get_form_report, get_form_series_report, get_segment_report and get_segment_series_report cover recipients, opens, clicks, conversions, revenue, unsubscribes, form submits and segment membership changes.
• Campaigns: read campaigns and send jobs with get_campaigns, get_campaign and get_campaign_send_job; build them with create_campaign, update_campaign, update_campaign_message and assign_template_to_campaign_message; send with send_campaign.
• Flows: get_flows and get_flow read flows, and update_flow_status sets a flow to live, draft or manual.
• Profiles and lists: get_profiles, get_profile, get_lists, get_list_profiles, create_profile, update_profile, create_list, update_list and add_profiles_to_list.
• Consent: subscribe_profile_to_marketing, unsubscribe_profile_from_marketing and suppress_profiles.
• Segments, events and metrics: get_segments, get_segment_profiles, get_events, get_metrics, get_custom_metrics, create_event and create_events_bulk.
• Templates: get_email_templates, create_email_template, update_email_template, clone_email_template and upload_image_from_url.
• Catalog, coupons and tags: get_catalog_items, create_catalog_item, update_catalog_item, get_coupons, create_coupon, create_coupon_codes, get_tags, get_tag_groups and create_tag.

Before you connect

• A Klaviyo account where you can create private API keys.
• A private API key that can read account info (the accounts:read scope). Klaviyo's setup guide in the app recommends Full Access; with custom permissions, include read access to the resources agents should use, and write scopes only if agents should make changes.
• An InsightfulPipe workspace with a brand for the account. Owners, admins and operators can add connections.

Connect Klaviyo

1. In the InsightfulPipe app, open Connectors, choose Klaviyo and click Connect.
2. In Klaviyo, go to Settings > API Keys and create a private API key with the permissions you want agents to have.
3. Copy the key, which starts with pk_, and paste it into Private API Key.
4. Click Test & Connect. InsightfulPipe checks the key with Klaviyo, stores it encrypted and detects whether it has write access.

Add the MCP server to your AI client

Server URL: https://klaviyo.insightfulmcp.com/ and server name: klaviyo-mcp.

• Claude: open Claude Connectors Settings, scroll to the bottom and click Add custom connector, paste the URL, click Add, then click Connect.
• ChatGPT: in ChatGPT Security Settings turn on Developer mode, click Create on the Connectors page, paste the URL, click Create, then click Connect. Turn the connector on in each new chat with + → More.
• Claude Code: run claude mcp add --transport http klaviyo-mcp https://klaviyo.insightfulmcp.com/, then type /mcp, select klaviyo-mcp and click Authenticate.
• Cursor: in the app, open MCP Servers, choose Klaviyo and click Install Klaviyo MCP, click Open Cursor then Install, then click Connect and Open.
• Gemini CLI: run gemini mcp add --transport http klaviyo-mcp https://klaviyo.insightfulmcp.com/, then /mcp auth klaviyo-mcp.
• Codex CLI: run codex mcp add klaviyo-mcp --url https://klaviyo.insightfulmcp.com/; authorization starts automatically.

Each client opens a browser window where you log in to InsightfulPipe and click Authorize access. Step-by-step guides: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex CLI. To reach every connected platform through one server, use the unified server.

Permissions and safety

• There is no Permissions picker for Klaviyo. A key without write access connects as Read Only, and a key with write access connects as Read & Write.
• cancel_campaign_send is the only destructive action, so it stays off until an owner, admin or operator enables it in Configure actions for this account.
• send_campaign, update_flow_status, unsubscribe_profile_from_marketing and suppress_profiles are regular write actions that are on for Read & Write connections. They reach real subscribers, so turn them off for accounts where agents should only prepare work.
• Writes need the Owner, Administrator or Operator role. Members with the User role can only run enabled read actions on accounts granted to them.

Limits

• Flow logic can't be built or edited; update_flow_status only changes a flow's status.
• There are no actions to create segments or to delete profiles, lists, campaigns or templates.
• Campaign and flow reports need a conversion metric and use your Placed Order metric when you don't name one.
• Write access is detected from the key as a whole. A key with any write scope connects as Read & Write, so a write the key isn't scoped for can still look enabled and then be rejected by Klaviyo.
• Klaviyo API rate limits apply. The server retries when Klaviyo asks it to slow down.

Example prompts

• "Using Klaviyo, which campaigns sent last month drove the most revenue?"
• "Show weekly revenue for our Welcome flow over the last 90 days."
• "What was the submit rate of each sign-up form this month?"
• "Create a draft campaign for our spring sale to the Newsletter list, but don't send it."

Troubleshooting

• "API key does not have permission to read account info. Please ensure it has accounts:read scope." Edit the key's permissions in Klaviyo, or create a new key with accounts:read, then connect again.
• A write is rejected by Klaviyo: the key is missing that resource's write scope. Update the key in Klaviyo and reconnect.
• "This action is disabled for this connected account. An owner or admin must enable it for the account." An owner, admin or operator can enable it in Configure actions for this account.
• "This account is connected read-only, so this action cannot be enabled for it. An owner or admin must reconnect it with Read & Write permissions." Reconnect with a private key that has write access.

FAQ

Is this Klaviyo's official MCP server?

No. Klaviyo publishes its own MCP server. InsightfulPipe is an independent hosted server that calls the Klaviyo API with your private API key and adds per-account action controls, team roles and your other connected platforms in the same workspace.

Can I connect more than one Klaviyo account?

Yes. Each connection is one Klaviyo account with its own private API key, and each connected account counts as one connection on your plan.

Does my AI client see the Klaviyo key?

No. The key is stored encrypted in InsightfulPipe. Your AI client signs in to the MCP server with your InsightfulPipe account.

Related

• Klaviyo MCP server
• Mailchimp connector
• Manage and move brand connections
• Workspace roles and permissions
• MCP troubleshooting