home / mcp / cakemail mcp server

Cakemail MCP Server

Provides enterprise-ready MCP capabilities to manage templates, contacts, campaigns, lists, transactional emails, and reporting via the Cakemail API.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cakemail-cakemail-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/cakemail-mcp-server/build/index.js"
      ],
      "env": {
        "CAKEMAIL_BASE_URL": "https://api.cakemail.dev",
        "CAKEMAIL_PASSWORD": "your-password",
        "CAKEMAIL_USERNAME": "[email protected]"
      }
    }
  }
}

You can run and connect to the Cakemail MCP Server to manage templates, contacts, campaigns, lists, transactional emails, sub-accounts, and rich analytics from an MCP-compatible client. This server provides enterprise-grade features with a focus on OpenAPI-compliant templates, BEEeditor integration, and robust production readiness.

How to use

You use an MCP client to interact with the Cakemail MCP Server through a local stdio-based runtime. Start the server in your environment, then configure your MCP client to point at the local process. The server exposes a comprehensive set of capabilities across templates, contacts, campaigns, lists, transactional emails, sub-accounts, and analytics. Use natural language commands in your MCP client to create, update, render, or query resources, and leverage the editor integrations for visual design where available.

How to install

Prerequisites: Node.js 18 or higher and a Cakemail account with API access. You will also use Claude Desktop or another MCP-compatible client to connect.

Install and run the MCP server locally

Configuration and startup

Configure your environment with your Cakemail credentials and base API URL, then set up your MCP client to load the server as a local stdio process.

Usage examples and workflows

Create, render, and manage templates, manage contacts and lists, build and send campaigns, handle transactional emails, and access rich reporting and analytics. Use the MCP client’s natural language commands to perform common workflows, such as creating a new template, rendering a preview, listing campaigns, or exporting campaign analytics.

Configuration, security, and troubleshooting

Review the security posture: OAuth 2.0 authentication with automatic token refresh, input validation, and HTTPS-only API communication. Manage credentials via environment variables and rotate them if needed. If you encounter authentication or connectivity issues, verify credentials, restart the MCP client, and test API connectivity from the MCP client with the provided health/status commands.

Testing

Use the built-in test and inspector commands in your MCP client to validate connectivity, verify template rendering, and ensure end-to-end flow through campaigns and reports.

Quick start commands

# Prerequisites
node --version
# Install dependencies
npm install
# Build the project
npm run build
# Run (example inline; actual startup is provided via the MCP runtime)
npm run start

Environment and startup example

{
  "mcpServers": {
    "cakemail": {
      "command": "node",
      "args": ["/absolute/path/to/cakemail-mcp-server/build/index.js"],
      "env": {
        "CAKEMAIL_USERNAME": "[email protected]",
        "CAKEMAIL_PASSWORD": "your-password",
        "CAKEMAIL_BASE_URL": "https://api.cakemail.dev"
      }
    }
  }
}

Verification and health checks

After you start the MCP server, verify health status in your MCP client and perform a quick connectivity check to ensure the server is reachable and responsive.

Available tools

Template Management

Create, update, delete, list, get, duplicate, render, and search templates with OpenAPI-compliant content structures and legacy compatibility.

Contact Management

Create, update, delete contacts with custom fields, list by lists, advanced segmentation, and engagement metrics.

Campaign Management

Create, update, list, delete campaigns; send campaigns to lists; schedule, test, render, and track performance; BEEeditor integration.

List Management

Create, update, delete lists; list with filtering; get details and statistics; archive with data preservation; analytics.

Transactional Email

Send transactional emails; track delivery; render previews; access detailed activity logs and statistics.

Enterprise Sub-Account Management

Manage sub-accounts with multi-tenant support, suspension, organization conversion, and advanced search.

Enhanced Reporting & Analytics

Modular reports, campaign analytics, email statistics, list/account analytics, export management, smart insights, and debugging tools.

Logs & Event Tracking

Campaign activity logs, workflow logs, delivery logs, and smart filtering for events.

Sender Management

Manage verified senders with status checks and authentication support.

BEEeditor Visual Design

Create basic BEEeditor templates, generate newsletters with sections, validate BEE templates, and drag-and-drop design.

Account Management

Get current account details, view retry configurations, and monitor health.

Production Infrastructure

Health monitoring, OAuth 2.0 with token refresh, retry/backoff, rate limiting, and queuing.