Klaviyo MCP Server (Beta)
The Klaviyo Model Context Protocol (MCP) server integrates with Klaviyo's APIs, allowing you to interact with your Klaviyo data using a variety of MCP clients. For a detailed guide on how to set up and use this server, see our Klaviyo MCP server guide.
[!WARNING] The Klaviyo MCP server is currently in beta and is subject to change. Please provide any feedback using this form.
Prerequisites
- uv
- A compatible MCP client (e.g., Cursor). Note: This server runs locally, so web-based clients such as ChatGPT are not supported at this time.
Quickstart
Create a Klaviyo private API key
To utilize all available tools, create a Klaviyo private API key with the following permissions:
| Scope | Access |
|---|---|
| Accounts | Read |
| Campaigns | Full |
| Catalogs | Read |
| Events | Full |
| Flows | Read |
| Images | Full |
| List | Read |
| Metrics | Read |
| Profiles | Full |
| Segments | Full |
| Subscriptions | Full |
| Tags | Read |
| Templates | Full |
Install uv
For macOS and Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
For Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Add the server to your MCP client
For guidance on securely configuring your MCP client, refer to our Klaviyo MCP server guide.
Available tools
| Category | Tool name | Description |
|---|---|---|
| Accounts | get_account_details |
Get details of your account. |
| Campaigns | get_campaigns |
List your campaigns. |
| Campaigns | get_campaign |
Get details of a campaign. |
| Campaigns | create_campaign |
Create a campaign. |
| Campaigns | assign_template_to_campaign_message |
Assign an email template to a campaign message. |
| Catalogs | get_catalog_items |
List your catalog items. |
| Events | get_events |
List events. |
| Events | create_event |
Create an event for a profile. |
| Events | get_metrics |
List event metrics. |
| Events | get_metric |
Get details of an event metric. |
| Flows | get_flows |
List your flows. |
| Flows | get_flow |
Get details of a flow. |
| Groups | get_lists |
List your lists. |
| Groups | get_list |
Get details of a list. |
| Groups | get_segments |
List your segments. |
| Groups | get_segment |
Get details of a segment. |
| Images | upload_image_from_file |
Upload image from a local file. |
| Images | upload_image_from_url |
Upload image from a URL. |
| Profiles | get_profiles |
List your profiles. |
| Profiles | get_profile |
Get details of a profile. |
| Profiles | create_profile |
Create a profile. |
| Profiles | update_profile |
Update a profile. |
| Profiles | subscribe_profile_to_marketing |
Subscribe a profile to marketing for a given channel and list. |
| Profiles | unsubscribe_profile_from_marketing |
Unsubscribe a profile from marketing for a given channel and list. |
| Reporting | get_campaign_report |
Get a report of your campaign performance. |
| Reporting | get_flow_report |
Get a report of your flow performance. |
| Templates | create_email_template |
Create an HTML email template. |
| Templates | get_email_template |
Get the details of an email template. |
1 maintainer
Release files for klaviyo-mcp-server 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| klaviyo_mcp_server-0.4.1.tar.gz | 66.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| klaviyo_mcp_server-0.4.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 110.3 kB
Release files / klaviyo_mcp_server-0.4.1.tar.gz
| Download URL | klaviyo_mcp_server-0.4.1.tar.gz |
|---|---|
| Size | 66.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5c5986d6952a7009976f28153e6110d5b28c2dfb13254ec4763d84856902a162
|
|
BLAKE2b-256 checksum How to use checksums |
18b61f0e0adc54c5af0d743d8301ce3ed2c84434c3bca13f67de2df6863641f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / klaviyo_mcp_server-0.4.1-py3-none-any.whl
| Download URL | klaviyo_mcp_server-0.4.1-py3-none-any.whl |
|---|---|
| Size | 43.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fbe8a1784754650c235fe7d0ea50c12705e852b57bd621dc5e6b66cbbfd4bc1
|
|
BLAKE2b-256 checksum How to use checksums |
2fd388921de87099c08bd64c4e71475b0548dab0c221341ec3793b5262398c43
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.30 {"installer":{"name":"uv","version":"0.9.30","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
