Cakemail MCP Server

Manage email marketing campaigns, contacts, and transactional emails with the Cakemail API.

An enterprise Model Context Protocol (MCP) server for integrating with the Cakemail API. This server provides comprehensive tools for email marketing campaigns, transactional emails, detailed reporting, advanced BEEeditor visual email design, template management, and complete list management through the Cakemail platform.

🎯 Version 1.10.0 - Complete Template Management

This version introducescomprehensive template management functionality, providing complete lifecycle management for email templates including creation, updating, duplication, and advanced filtering capabilities with support for modern OpenAPI content structures.

- ✅ Create, update, and delete email templates with modern content structure
- ✅ List templates with advanced filtering, sorting, and pagination
- ✅ Get individual template details and metadata
- ✅ Duplicate templates with smart naming and tag preservation
- ✅ Render templates for HTML preview and testing
- ✅OpenAPI-compliant content structure(html, text, bee, custom)
- ✅Backward compatibilitywith legacy template formats
- ✅Multi-account supportfor enterprise environments
- ✅Advanced filteringby tags, name, ownership status
- ✅Template searchby name, tags, or ownership

- ✅ Create, update, and delete contacts with custom fields
- ✅ List contacts with filtering by list ID
- ✅ Advanced contact segmentation support
- ✅ Contact engagement metrics

- ✅ Create, update, and delete email campaigns
- ✅ List campaigns with advanced filtering and pagination
- ✅ Send campaigns to contact lists
- ✅ Campaign performance metrics (via Reports API)
- ✅ Get latest campaign with one command
- ✅BEEeditor integrationfor visual email design
- ✅JSON-based email templateswith drag-and-drop structure
- ✅Newsletter template generationwith automated layout
- ✅ Campaign scheduling, suspension, and lifecycle management
- ✅ Campaign testing, preview, and revision history
- ✅ Campaign archiving and link tracking

- ✅ Create, update, and delete contact lists
- ✅ List all lists with advanced filtering and pagination
- ✅ Get detailed list information and statistics
- ✅ Archive lists while preserving data
- ✅ Comprehensive list performance analytics
- ✅ Multi-language support and sender configuration
- ✅ Webhook integration for real-time list events
- ✅ Account scoping for enterprise environments

- ✅ Send individual transactional and marketing emails
- ✅ Email status tracking and delivery monitoring
- ✅ HTML and plain text content support
- ✅ Email rendering and preview capabilities
- ✅ Comprehensive email activity logs with filtering
- ✅ Email statistics with time-based analytics
- ✅ Advanced email logs with performance analysis
- ✅ Debug tools for email API testing

🏢 Enterprise Sub-Account Management (14 tools)

- ✅ Create, update, and delete sub-accounts
- ✅ Multi-tenant support for agencies
- ✅ Account suspension/unsuspension
- ✅ Organization conversion
- ✅ Email verification workflows
- ✅ Advanced filtering and search capabilities
- ✅ Debug and troubleshooting utilities

📊 Enhanced Reporting & Analytics (12 tools)

- ✅Modular Reports Architecturewith focused, maintainable modules
- ✅Campaign Analyticswith detailed performance insights and link analysis
- ✅Email API Statisticsfor transactional email performance
- ✅List & Account Analyticswith growth metrics and deliverability health
- ✅Smart Performance Benchmarkingwith industry standard comparisons
- ✅Intelligent Link Analysiswith automatic categorization and optimization
- ✅Visual Performance Indicators(🚀👍 ⚠️ 🛑) for quick assessment
- ✅Actionable Recommendationsbased on performance patterns
- ✅Export Managementwith progress tracking and lifecycle management
- ✅Campaign Reports Export(CSV/XLSX) with comprehensive data
- ✅Suppressed Emails Exportfor compliance and deliverability
- ✅Debug Toolsfor API connectivity testing

- ✅ Campaign activity logs with advanced sequence analysis
- ✅ Workflow automation logs
- ✅ Transactional email delivery logs
- ✅ Contact list activity logs
- ✅ Smart filtering and event categorization
- ✅ Debug tools for logs API testing

- ✅ Create, update, and delete verified senders
- ✅ List all senders with verification status
- ✅ Complete sender authentication support

- ✅ Create basic BEEeditor template structures
- ✅ Generate complete newsletter templates with sections
- ✅ Validate BEE JSON templates against schema
- ✅ Drag-and-drop email design capabilities

- ✅ Get current account details and information
- ✅ View retry configuration and API settings
- ✅ Account health monitoring and diagnostics

- ✅ Health monitoring and API connection validation
- ✅ OAuth 2.0 authentication with automatic token refresh
- ✅ Retry logic with exponential backoff
- ✅ Rate limiting and circuit breaker protection
- ✅ Request queuing and concurrency control
- ✅ Comprehensive error handling

Total Implemented: 87+ tools across 11 feature categories

- Node.js18 or higher
- Cakemail accountwith API access
- Claude Desktopor another MCP-compatible client

git clone https://github.com/cakemail/cakemail-mcp-server.git cd cakemail-mcp-server

CAKEMAIL_USERNAME=your-email@example.com CAKEMAIL_PASSWORD=your-password CAKEMAIL_BASE_URL=https://api.cakemail.dev

Add the server to your Claude Desktop configuration:

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

{ "mcpServers": { "cakemail": { "command": "node", "args": ["/absolute/path/to/cakemail-mcp-server/build/index.js"], "env": { "CAKEMAIL_USERNAME": "your-email@example.com", "CAKEMAIL_PASSWORD": "your-password" } } } }

In Claude Desktop:"Check my Cakemail API health status"

"Show me my latest campaigns with analytics"

"Show me my account details" "What's my current retry configuration?"

"Create a new sub-account for our client 'Acme Corp' with the email admin@acmecorp.com" "List all active sub-accounts and show their verification status" "Suspend the sub-account for client XYZ temporarily" "Convert sub-account 12345 to an organization"

"List all my email templates sorted by creation date" "Create a new template called 'Welcome Email' with modern content structure" "Get the details of template ID 123 including its content and metadata" "Update my newsletter template with new HTML content and add marketing tags" "Duplicate the welcome email template as 'Welcome Email - French'" "Show me a preview of template 456 by rendering it to HTML" "Delete the old product launch template that's no longer needed" "Find all templates tagged with 'newsletter' that I own"

"Create a new email campaign called 'Holiday Sale 2024' with the subject 'Save 50% on Everything!' and send it to my newsletter list"

"Create a BEE newsletter template with sections for product announcements and customer testimonials" "Generate a basic BEE template for welcome emails with our brand colors" "Validate my custom BEE template and show me the structure" "Create a campaign using BEE format with a professional newsletter layout"

"Send a transactional welcome email to sara@example.com with our onboarding template"

"Show me the performance metrics for my latest campaign including open rates and click rates" "Create a CSV export of all my campaign performance data for the last quarter" "Get detailed campaign logs for campaign 12345 with advanced sequence analysis to see the complete user journey" "Analyze campaign 789 logs to identify drop-off points and get optimization recommendations" "Export the performance data for all my campaigns this year in Excel format" "Show me link performance analysis for my newsletter campaign with categorization insights" "Generate performance benchmarks comparing my open rates to industry standards"

The reports functionality is built on amodular architecturefor enhanced maintainability:

Each module provides focused functionality while sharing common analytics utilities for consistent performance benchmarking and intelligent recommendations.

The server includes production-ready features:

- Automatic Retry: Exponential backoff with jitter
- Rate Limiting: Respects API limits and server responses
- Circuit Breaker: Automatic failure detection and recovery
- Request Queuing: Concurrency control for batch operations

Comprehensive error types with detailed messages:

- Authentication Errors: Clear credential guidance
- Validation Errors: Field-specific error details
- Rate Limit Errors: Automatic retry timing
- Network Errors: Connection and timeout handling

- VerifyCAKEMAIL_USERNAMEandCAKEMAIL_PASSWORD
- Ensure API access is enabled on your account

npm run clean && npm run rebuild

- Restart Claude Desktop completely
- Wait for full load, then test new commands

# Test in Claude Desktop "Check my Cakemail API connection"

- OAuth 2.0authentication with automatic token refresh
- Input validationto prevent injection attacks
- Secure credential storageusing environment variables
- Rate limitingto prevent abuse
- HTTPS-onlyAPI communication

Never commit credentials to version control!Always use environment variables for sensitive data:
- Copy.env.exampleto.env
- Add your actual credentials to.env
- Ensure.envis listed in.gitignore(already configured)
- If credentials are accidentally exposed, rotate them immediately in your Cakemail account

- Cakemail API:https://cakemail.dev
- List Management Guide:docs/list-management.md
- BEEeditor Integration:docs/BEE_EDITOR_INTEGRATION.md
- MCP Protocol:https://github.com/modelcontextprotocol
- Issues:https://github.com/cakemail/cakemail-mcp-server/issues

This project is licensed under the MIT License - see theLICENSEfile for details.

Turn an AI tool into your smart email engine