Connect to the MCP server

You will learn

To communicate with the Klaviyo MCP server, each MCP client needs specific configuration. This page walks you through configuring various MCP clients for both the remote-hosted MCP server (recommended) and the local MCP server, and how to control server behavior with query parameters and environment variables.

Configure your MCP client for the remote-hosted server (recommended)

🚧

This feature is only available to Klaviyo users with an Owner, Admin, or Manager role. Learn more about Klaviyo user roles.

📘

By default, the remote-hosted server includes many tools. If your client has a smaller context window or you want to improve tool-selection accuracy, add the core-tools-only=true query parameter to limit the server to the ~40 core tools (see Query parameters).

To communicate with the Klaviyo MCP server, each MCP client needs specific configuration. Follow the steps below to get started:

1. Log in to the Klaviyo account you'd like to use.
2. Follow the steps below for the MCP client you’d like to configure.

Claude

Listed Connector (recommended for connecting to a single Klaviyo account)

The listed Klaviyo connector is the simplest way to access Klaviyo within Claude.

1. In Claude, navigate to Settings > Connectors.

2. Click Browse Connectors.

3. Search for Klaviyo and connect.

4. Review the Claude access and click Approve.

5. Review the permissions for your Klaviyo account and click Allow.

You're now ready to ask Claude about your Klaviyo data.

Custom Connector (recommended for connecting to several Klaviyo accounts)

🚧

This feature is only available to Claude and Claude Desktop for users on Pro, Max, Team, and Enterprise plans.

For each Klaviyo account you would like to add,

1. In Claude, navigate to Settings > Connectors.

2. Click Add custom connector.

3. Enter the following details in the connector modal:
   a. Name: Klaviyo

   1. If adding multiple accounts, include the name of the account you are connecting to distinguish it from others (e.g. "Klaviyo - Example Company")

   b. Remote MCP server URL: https://mcp.klaviyo.com/mcp

   1. If adding multiple accounts, include the name of the account as a query parameter (e.g. "https://mcp.klaviyo.com/mcp?company=example-company")

   c. Click Add.

4. Next to the connector, click Connect.

5. Review the Claude access and click Approve.

6. Review the permissions for your Klaviyo account and click Allow.

For each new chat, click + > Connectors and ensure that only the relevant connector is enabled.

ChatGPT

ChatGPT App (recommended for connecting to a single Klaviyo account)

The Klaviyo ChatGPT App is the simplest way to interact with your account data within ChatGPT. For detailed instructions, refer to how to use the Klaviyo app for ChatGPT.

ChatGPT Custom MCP Server (recommended for connecting to several Klaviyo accounts)

First,

1. In ChatGPT, navigate to Settings > Apps.

2. In Advanced settings, toggle Developer mode on.

For each Klaviyo account you would like to add,

1. Click Create app.

2. Enter the following details in the connector modal:
   a. Name: Klaviyo

   1. If adding multiple accounts, include the name of the account you are connecting to distinguish it from others (e.g. "Klaviyo - Example Company")

   b. MCP Server URL: https://mcp.klaviyo.com/mcp
   c. Authentication: Select OAuth
   d. Select I understand and want to continue
   e. Click Create.

3. Review the ChatGPT access and click Approve.

4. If adding multiple accounts, choose the account you want to connect.

5. Review the permissions for your Klaviyo account and click Allow.

For each new chat, click + > More and select the correct server.

Cursor

1. Download Cursor.

2. Open Cursor. Within Settings > Cursor Settings > MCP > New MCP Server, add the following:

{
  "mcpServers": {
    "klaviyo": {
      "url": "https://mcp.klaviyo.com/mcp"
    }
  }
}

See Query parameters to choose any query parameters you'd like to add to control server behavior.

3. Save your changes and navigate to Settings > Cursor Settings > Tools & Integrations. Click Needs login. You will be prompted to authenticate the server.

🚧

If you encounter authentication errors, first Logout of the MCP Server and reauthenticate. If that fails, sign out of your Cursor account and then sign back in.

4. Verify the connection by looking for visual indicators and asking a question to test the connection.

VS Code

1. Download VS Code.

2. Open VS Code. Within MCP User Configuration (Ctrl + Shift + P > MCP: Open User Configuration), add the following:

{
	"servers": {
		"klaviyo": {
			"url": "https://mcp.klaviyo.com/mcp"
		}
	}
}

If you already have a servers entry, append the Klaviyo configuration to it.

See Query parameters to choose any query parameters you'd like to add to control server behavior.

3. Save your changes. From the command palette (Ctrl+Shift+P on Windows or Cmd+Shift+P on Mac), search for MCP: List Servers, then select klaviyo > Start Server. You will be prompted to authenticate the server.

🚧

The remote MCP server connection can sometimes take time to fully initialize and load all available tools. If the server fails to start or your initial test query does not work, you may need to restart VS Code a few times for the connection to fully register.

4. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

To enable only the tools that do not modify any Klaviyo data, add the query parameter read-only=true to the URL in your MCP client’s configuration file.

Other Clients

Our server is compatible with any MCP client that supports remote servers. You may need the following info when connecting:

• URL: https://mcp.klaviyo.com/mcp
• Authentication method: OAuth (with dynamic client registration)
• Transport: Streamable HTTP

Query parameters

You can control server behavior with query parameters.

🚧

Query parameters can't be controlled with the listed Claude connector or the listed ChatGPT app. To use them, set up a custom connector instead (see Custom Connector under Claude and ChatGPT Custom MCP Server under ChatGPT above).

Here's an example of what your URL may look like:

https://mcp.klaviyo.com/mcp?read-only=true&disable-tools-with-user-generated-content=true&core-tools-only=true&toolsets=profiles:read,campaigns:read

Configure your MCP client for the local server

To use the local MCP server, you’ll need:

• uv
• A compatible MCP client (e.g., Cursor). For web-based clients such as ChatGPT, use our remote-hosted server.

To communicate with the Klaviyo MCP server, each MCP client needs specific configuration. Follow the steps below to get started:

1. To utilize all available tools, create a Klaviyo private API key with the following permissions:

2. Follow the steps below for the MCP client you’d like to configure.

📘

You can add multiple Klaviyo accounts to your MCP client's configuration file to switch between accounts without editing the file each time. Just be sure to reference the desired account in each prompt.

Claude Desktop

1. Download Claude Desktop.

2. Open Claude Desktop. Within Settings > Developer > Edit Config, add the following, substituting your API key:

{
 "mcpServers": {
   "klaviyo": {
     "command": "uvx",
     "args": ["klaviyo-mcp-server@latest"],
     "env": {
       "PRIVATE_API_KEY": "YOUR_API_KEY",
       "READ_ONLY": "false",
       "ALLOW_USER_GENERATED_CONTENT": "false"
     }
   }
 }
}

3. Once you have saved all configuration changes, terminate all Claude processes and relaunch Claude to apply the new settings.

4. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

If you get errors upon starting Claude, you may need to provide the full path to the uvx executable for the command key. On macOS, find this by running which uvx.

5. (Recommended for security) To avoid storing your API key in plaintext, save your API key in your password manager. Then, use the following command to launch Claude, pasting in your API key when prompted:

uvx --from klaviyo-mcp-server@latest run-claude

Note that as of now, this only supports MacOS and Windows.

📘

Note for free users

The free version of Claude Desktop has a very limited context window, and you may run into issues with all the tools enabled. Here are a few possible workarounds:

1. Only enable the tools you need. To do this, click the Search and tools button near the prompt. Then, click klaviyo to toggle certain tools on or off.
2. Use read-only mode, i.e., set READ_ONLY to true.
3. Use a different client.

Cursor

1. Download Cursor.

2. Open Cursor. Within Settings > Cursor Settings > Tools & Integrations > Add Custom MCP, add the following, substituting your API key:

{
  "mcpServers": {
    "klaviyo": {
      "command": "uvx",
      "args": ["klaviyo-mcp-server@latest"],
      "env": {
        "PRIVATE_API_KEY": "YOUR_API_KEY",
        "READ_ONLY": "false",
        "ALLOW_USER_GENERATED_CONTENT": "false"
      }
    }
  }
}

3. Once you have saved all configuration changes, terminate all Cursor processes and relaunch Cursor to apply the new settings.

4. Verify the connection by looking for visual indicators and asking a question to test the connection.

5. (Recommended for security) To avoid storing your API key in plaintext, save your API key in your password manager. Then, use the following command to launch Cursor, pasting in your API key when prompted:

uvx --from klaviyo-mcp-server@latest run-cursor

Note that as of now, this only supports MacOS and Windows.

VS Code

1. Download VS Code.

2. Open VS Code. Within settings (Ctrl + Shift + P > Preferences: Open Settings (JSON)), add the following:

{
  "mcp": {
    "servers": {
      "klaviyo": {
        "command": "uvx",
        "args": ["klaviyo-mcp-server@latest"],
        "env": {
          "PRIVATE_API_KEY": "${input:klaviyo_api_key}",
          "READ_ONLY": "false",
          "ALLOW_USER_GENERATED_CONTENT": "false"
        }
      }
    },
    "inputs": [
      {
        "type": "promptString",
        "id": "klaviyo_api_key",
        "description": "Klaviyo API Key",
        "password": true
      }
    ]
  }
}

3. Once you have saved all configuration changes, terminate all VS Code processes and relaunch VS Code to apply the new settings.

4. Verify the connection by looking for visual indicators and asking a question to test the connection.

📘

To enable only the tools that do not modify any Klaviyo data, set the READ_ONLY environment variable to true in your MCP client’s configuration file.

Environment configuration

The Klaviyo MCP server provides some configuration options which can be controlled with environment variables.

Add multiple accounts to your configuration file

To avoid editing your MCP client's configuration file each time you switch Klaviyo accounts, you can add multiple accounts to the file.

To do this:

1. Copy and paste the same configuration shown above for each account you want to add.
2. Update the name, i.e., klaviyo, to something more descriptive for each account, and replace the API keys accordingly.

Your config file should look like this:

{ 
  "mcpServers": { 
    "klaviyo_company1": { 
      "command": "uvx", 
      "args": ["klaviyo-mcp-server@latest"], 
      "env": { 
        "PRIVATE_API_KEY": "YOUR_API_KEY_1", 
        "READ_ONLY": "false", 
        "ALLOW_USER_GENERATED_CONTENT": "false" 
      } 
    },
    "klaviyo_company2": { 
      "command": "uvx", 
      "args": ["klaviyo-mcp-server@latest"], 
      "env": { 
        "PRIVATE_API_KEY": "YOUR_API_KEY_2", 
        "READ_ONLY": "false", 
        "ALLOW_USER_GENERATED_CONTENT": "false" 
      } 
    }
  } 
}

Troubleshooting

If you are having trouble connecting to the remote server:

• Ensure the URL is correct and there is no trailing slash: https://mcp.klaviyo.com/mcp.
• Ensure you have the Owner, Admin, or Manager role on the Klaviyo account.

If your MCP client can’t find enabled MCP tools for Klaviyo:

1. Review the steps above and ensure the MCP server is configured correctly.
2. Terminate all processes and relaunch the app to refresh your client.

If you’re getting inaccurate or inconsistent responses:

• Start a new chat to reset the conversation context.
• Be specific in your queries by providing necessary, relevant keywords.