Klaviyo MCP Server

by relay-commerce

294 downloads

Not rated

GitHub

Other

Description

# Klaviyo MCP Server A comprehensive Model Context Protocol (MCP) server that provides complete access to Klaviyo's API functionality. This server enables AI assistants like Claude to interact with all major Klaviyo APIs through 34+ tools covering profiles, campaigns, flows…

About

Details

Author: relay-commerce
Downloads: 294
Categories: Other

- 34 tools covering all major Klaviyo API endpoints
- Secure authentication using Klaviyo private API keys
- Comprehensive error handling and rate limiting protection
- Input validation for all parameters and JSON data
- JSON:API format support with filtering, pagination, and sorting
- Consistent interface across all tools with complete documentation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Klaviyo MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

From the repository

Install via cloning the repository and running the setup script or manually creating a Python virtual environment. Configure by adding the server to Claude Desktop's configuration file (claude_desktop_config.json) or use the MCP CLI to list and call tools. Each tool requires a Klaviyo Private API key passed as a parameter.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "klaviyo mcp server": {
            "klaviyo-mcp-server-relay-commerce": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "klaviyo_mcp_env"
                ]
            }
        }
    }
}

McpServers

{
    "klaviyo-mcp-server-relay-commerce": {
        "command": "python3",
        "args": [
            "-m",
            "venv",
            "klaviyo_mcp_env"
        ]
    }
}

Klaviyo MCP Server

A comprehensive Model Context Protocol (MCP) server that provides complete access to Klaviyo's API functionality. This server enables AI assistants like Claude to interact with all major Klaviyo APIs through 34+ tools covering profiles, campaigns, flows, lists, segments, events, and more.

🚀 Features

Complete API Coverage

- Profiles API (4 tools) - Create, read, update, search customer profiles - Lists API (4 tools) - Manage lists and list memberships - Campaigns API (4 tools) - Create, manage, and send email campaigns - Segments API (3 tools) - Create and query dynamic customer segments - Events API (3 tools) - Track and retrieve customer events - Flows API (3 tools) - Manage automated email flows - Metrics API (2 tools) - Access performance metrics - Templates API (2 tools) - Manage email templates - Catalogs API (3 tools) - Manage product catalogs and variants - Coupons API (2 tools) - Create and manage discount coupons - Reporting API (2 tools) - Query campaign and flow analytics - Accounts API (2 tools) - Access account information

Key Features

- ✅ 34 tools covering all major Klaviyo API endpoints - ✅ Secure authentication using Klaviyo private API keys - ✅ Comprehensive error handling for network, HTTP, and API errors - ✅ Rate limiting protection with timeout and retry logic - ✅ Input validation for all parameters and JSON data - ✅ Consistent interface - all tools follow the same patterns - ✅ JSON:API format support with filtering, pagination, and sorting - ✅ Complete documentation with usage examples

📋 Prerequisites

- Python 3.10 or higher
- Klaviyo account with API access
- Klaviyo Private API Key (Get yours here)

🛠️ Installation

Quick Setup

1. Clone the repository:

   git clone https://github.com/relay-commerce/Klaviyo-MCP-Server.git

   cd Klaviyo-MCP-Server

2. Run the setup script:

   chmod +x klaviyo_setup.sh

   ./klaviyo_setup.sh

3. Get your Klaviyo API key:
- Go to Klaviyo API Keys
- Create a new private API key with appropriate scopes

Manual Setup

1. Create virtual environment:

   python3 -m venv klaviyo_mcp_env

   source klaviyo_mcp_env/bin/activate

2. Install dependencies:

   pip install -r klaviyo_requirements.txt

🧪 Testing

Test the server to ensure everything is working:

source klaviyo_mcp_env/bin/activate
python test_klaviyo_server.py

You should see output confirming all 34 tools are available:

✅ SUCCESS: All expected tools are available!

Test completed. Total tools available: 34

🔧 Usage

With Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "klaviyo": {
      "command": "python",
      "args": ["/absolute/path/to/klaviyo_mcp_server.py"]
    }
  }
}

With MCP CLI

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Klaviyo MCP Server

🚀 Features

Complete API Coverage

Key Features

📋 Prerequisites

🛠️ Installation

Quick Setup

Manual Setup

🧪 Testing

🔧 Usage

With Claude Desktop

With MCP CLI

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀