# Klaviyo MCP Server (Beta)
The Klaviyo [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server integrates with [Klaviyo's APIs](https://developers.klaviyo.com/en/reference/api_overview), 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](https://developers.klaviyo.com/en/docs/klaviyo_mcp_server).
> [!WARNING]
> The Klaviyo MCP server is currently in beta and is subject to change. Please provide any feedback using [this form](https://docs.google.com/forms/d/e/1FAIpQLSday2sqDvxfoRxjLrhROYZtxivRfHF151tcXV7o-ZYGF2SipQ/viewform?usp=header).
## Prerequisites
- [uv](https://docs.astral.sh/uv/getting-started/installation/)
- 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<a id="create-a-klaviyo-private-key"></a>
To utilize all [available tools](#available-tools), create a [Klaviyo private API key](https://developers.klaviyo.com/en/docs/authenticate_#create-a-private-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](https://docs.astral.sh/uv/getting-started/installation/)<a id="install-uv"></a>
For macOS and Linux:
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
For Windows:
```bat
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
### Add the server to your MCP client<a id="add-the-server-to-your-mcp-client"></a>
For guidance on securely configuring your MCP client, refer to our [Klaviyo MCP server guide](https://developers.klaviyo.com/en/docs/klaviyo_mcp_server).
## Available tools<a id="available-tools"></a>
| 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. |
Raw data
{
"_id": null,
"home_page": null,
"name": "klaviyo-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "ai, klaviyo ai, mcp, Klaviyo, Klaviyo api",
"author": "Klaviyo Developer Experience Team",
"author_email": "Klaviyo Developer Experience Team <developers@klaviyo.com>",
"download_url": "https://files.pythonhosted.org/packages/e7/67/3e007f331bb565963aeca630787dfafd0854d605de85884f44a354f1a471/klaviyo_mcp_server-0.2.2.tar.gz",
"platform": null,
"description": "# Klaviyo MCP Server (Beta)\n\nThe Klaviyo [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server integrates with [Klaviyo's APIs](https://developers.klaviyo.com/en/reference/api_overview), 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](https://developers.klaviyo.com/en/docs/klaviyo_mcp_server).\n\n> [!WARNING]\n> The Klaviyo MCP server is currently in beta and is subject to change. Please provide any feedback using [this form](https://docs.google.com/forms/d/e/1FAIpQLSday2sqDvxfoRxjLrhROYZtxivRfHF151tcXV7o-ZYGF2SipQ/viewform?usp=header).\n\n## Prerequisites\n\n- [uv](https://docs.astral.sh/uv/getting-started/installation/)\n- 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.\n\n## Quickstart\n\n### Create a Klaviyo private API key<a id=\"create-a-klaviyo-private-key\"></a>\n\nTo utilize all [available tools](#available-tools), create a [Klaviyo private API key](https://developers.klaviyo.com/en/docs/authenticate_#create-a-private-key) with the following permissions:\n\n| Scope | Access |\n| ------------- | ------ |\n| Accounts | Read |\n| Campaigns | Full |\n| Catalogs | Read |\n| Events | Full |\n| Flows | Read |\n| Images | Full |\n| List | Read |\n| Metrics | Read |\n| Profiles | Full |\n| Segments | Full |\n| Subscriptions | Full |\n| Tags | Read |\n| Templates | Full |\n\n### Install [uv](https://docs.astral.sh/uv/getting-started/installation/)<a id=\"install-uv\"></a>\n\nFor macOS and Linux:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nFor Windows:\n\n```bat\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n### Add the server to your MCP client<a id=\"add-the-server-to-your-mcp-client\"></a>\n\nFor guidance on securely configuring your MCP client, refer to our [Klaviyo MCP server guide](https://developers.klaviyo.com/en/docs/klaviyo_mcp_server).\n\n## Available tools<a id=\"available-tools\"></a>\n\n| Category | Tool name | Description |\n| --------- | ------------------------------------- | ------------------------------------------------------------------ |\n| Accounts | `get_account_details` | Get details of your account. |\n| Campaigns | `get_campaigns` | List your campaigns. |\n| Campaigns | `get_campaign` | Get details of a campaign. |\n| Campaigns | `create_campaign` | Create a campaign. |\n| Campaigns | `assign_template_to_campaign_message` | Assign an email template to a campaign message. |\n| Catalogs | `get_catalog_items` | List your catalog items. |\n| Events | `get_events` | List events. |\n| Events | `create_event` | Create an event for a profile. |\n| Events | `get_metrics` | List event metrics. |\n| Events | `get_metric` | Get details of an event metric. |\n| Flows | `get_flows` | List your flows. |\n| Flows | `get_flow` | Get details of a flow. |\n| Groups | `get_lists` | List your lists. |\n| Groups | `get_list` | Get details of a list. |\n| Groups | `get_segments` | List your segments. |\n| Groups | `get_segment` | Get details of a segment. |\n| Images | `upload_image_from_file` | Upload image from a local file. |\n| Images | `upload_image_from_url` | Upload image from a URL. |\n| Profiles | `get_profiles` | List your profiles. |\n| Profiles | `get_profile` | Get details of a profile. |\n| Profiles | `create_profile` | Create a profile. |\n| Profiles | `update_profile` | Update a profile. |\n| Profiles | `subscribe_profile_to_marketing` | Subscribe a profile to marketing for a given channel and list. |\n| Profiles | `unsubscribe_profile_from_marketing` | Unsubscribe a profile from marketing for a given channel and list. |\n| Reporting | `get_campaign_report` | Get a report of your campaign performance. |\n| Reporting | `get_flow_report` | Get a report of your flow performance. |\n| Templates | `create_email_template` | Create an HTML email template. |\n| Templates | `get_email_template` | Get the details of an email template. |\n",
"bugtrack_url": null,
"license": null,
"summary": "Klaviyo MCP Server",
"version": "0.2.2",
"project_urls": null,
"split_keywords": [
"ai",
" klaviyo ai",
" mcp",
" klaviyo",
" klaviyo api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2e27d98a9df0ea30805383e1364dfa0753125f41f38c08d0a152f53086fb98b0",
"md5": "76e5c65b5e57bd3e0c98183bab04d055",
"sha256": "3cef1db8b04a1cf8882ab1fbc21a99b8ff5ec32c00b55feda33849f18b5485e4"
},
"downloads": -1,
"filename": "klaviyo_mcp_server-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "76e5c65b5e57bd3e0c98183bab04d055",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 37626,
"upload_time": "2025-08-07T13:37:23",
"upload_time_iso_8601": "2025-08-07T13:37:23.020331Z",
"url": "https://files.pythonhosted.org/packages/2e/27/d98a9df0ea30805383e1364dfa0753125f41f38c08d0a152f53086fb98b0/klaviyo_mcp_server-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e7673e007f331bb565963aeca630787dfafd0854d605de85884f44a354f1a471",
"md5": "5000058517a24a1261ed67edfdb6ae2d",
"sha256": "e07e4c273113031175c9e802aeb46f05da87feb0201158a8144a7aec42d169fa"
},
"downloads": -1,
"filename": "klaviyo_mcp_server-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "5000058517a24a1261ed67edfdb6ae2d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 60682,
"upload_time": "2025-08-07T13:37:23",
"upload_time_iso_8601": "2025-08-07T13:37:23.881798Z",
"url": "https://files.pythonhosted.org/packages/e7/67/3e007f331bb565963aeca630787dfafd0854d605de85884f44a354f1a471/klaviyo_mcp_server-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 13:37:23",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "klaviyo-mcp-server"
}
JSON