What You'll Set Up

By the end of this guide, your AI agent will be able to manage your Klaviyo account — working with campaigns, segments, flows, profiles, and more. The entire setup takes about five minutes.

Klaviyo

70 tools · Email & SMS marketing automation for AI agents

Before You Begin

Make sure you have:

A Klaviyo account — Create one for free if you don't have one
A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already

Steps

Get your Klaviyo Private API key

Log into your Klaviyo account. Go to Settings > Account > API Keys. Create a new Private API Key or copy an existing one. Private keys start with pk_.

Info

Make sure you use a Private API Key, not a public one. Public keys (starting with pk_pub_) don't have the permissions needed for most operations.

Open your Pipeworks console

Log into your Pipeworks workspace and go to the Integrations page. Find Klaviyo in the list and click on it.

Enter your credentials

Paste your Klaviyo Private API key into the API Key field and click Connect.

Pipeworks encrypts your key with AES-256-GCM before storing it. The plaintext key is never saved to disk and is only decrypted when your integration container starts.

Start the integration

Click Start to launch the Klaviyo integration container. This takes a few seconds. Once the status shows Running, your agent is ready to use Klaviyo tools.

Test the connection

Use the Test button in your Pipeworks console to verify the connection. This sends a simple API call to Klaviyo to confirm your key works.

What Your Agent Can Do

Once connected, your AI agent has access to Klaviyo tools for:

Campaigns — Create, update, send, and analyze email campaigns
Flows — Manage automated email flows and their actions
Profiles — Create, update, search, and segment customer profiles
Lists & Segments — Manage subscriber lists and audience segments
Templates — Create and render email templates
Metrics & Events — Track and query event data and metric aggregates

Tip

Use tool profiles to control what your agent can do. Set the profile to read-only if you only want your agent to retrieve data, not modify anything.

Connecting from Your AI Agent

Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:

json

{
  "mcpServers": {
    "pipeworks-klaviyo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/klaviyo"]
    }
  }
}

Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.

Troubleshooting

Connection test fails? Double-check that you copied the full Private API key from Klaviyo. It should start with pk_.

Container won't start? Make sure your integration is enabled. An admin needs to assign the Klaviyo integration to your workspace first.

Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.

Connect Klaviyo to Pipeworks

Prerequisites