概要
What is Klaviyo MCP Server?
An MCP server that provides complete access to Klaviyo's API functionality through 34+ tools covering profiles, campaigns, flows, lists, segments, events, metrics, templates, catalogs, coupons, reporting, and accounts. Designed for AI assistants like Claude to interact with Klaviyo programmatically.
How to use Klaviyo MCP Server?
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.
Key features of Klaviyo MCP Server
- 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
Use cases of Klaviyo MCP Server
- AI-powered customer service automation using Klaviyo profile data
- Automated marketing campaign creation and sending via assistants
- Querying customer segments and events for data analysis workflows
- Managing product catalogs, coupons, and email templates programmatically
- Integrating Klaviyo analytics into business intelligence pipelines
FAQ from Klaviyo MCP Server
What dependencies does this server require?
Python 3.10 or higher, a Klaviyo account with API access, and a Klaviyo Private API Key. Dependencies are listed in klaviyo_requirements.txt.
How is authentication handled?
Each tool requires an api_key parameter passed at call time. API keys must have appropriate scopes (e.g., profiles:read, campaigns:write). Keys are never hardcoded; all requests use HTTPS.
What are the rate limits for Klaviyo?
Klaviyo allows 75 requests per second (burst) and 700 requests per minute (steady). The server includes timeout handling and error messages for rate limit scenarios.
How do I test that the server is working?
Run python test_klaviyo_server.py after activating the virtual environment. Successful output confirms all 34 tools are available.
Which APIs are covered?
Profiles, Lists, Campaigns, Segments, Events, Flows, Metrics, Templates, Catalogs, Coupons, Reporting, and Accounts APIs. Each has multiple tools detailed in the README.
