Smartlead Simplified MCP Server

This application provides a simplified interface to the Smartlead API, allowing AI assistants and automation tools to interact with Smartlead’s email marketing features. We welcome contribution from the community.

Licensing: All features are now enabled by default with maximum permissiveness! No license key required.

For developer details: See DEVELOPER_ONBOARDING.md

Quick Start

Installation

npm install [email protected]

or use directly with npx (no installation needed):

Installing via Smithery

To install Smartlead Campaign Management Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jean-technologies/smartlead-mcp-server-local --client claude

With Claude:

npx smartlead-mcp-server start

With n8n:

npx smartlead-mcp-server sse

First run will prompt for your Smartlead API Key. No license key is required.

Integration Examples

Claude Extension:

{
  "mcpServers": {
    "smartlead": {
      "command": "npx",
      "args": ["smartlead-mcp-server", "start"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      }
    }
  }
}

n8n Setup:

1. Start the server: npx smartlead-mcp-server sse
2. Configure n8n MCP Client node with:
   • SSE URL: http://localhost:3000/sse
   • Message URL: http://localhost:3000/message

Available Features

All features are now enabled by default, including:

• Campaign & Lead Management
• Statistics and Analytics
• Smart Delivery & Webhooks
• n8n Integration
• Client Management
• Smart Senders
• Download Tracking and Analytics

New Download Tracking Features

This release adds new download tracking capabilities:

Download Campaign Data

Download campaign data with tracking using the smartlead_download_campaign_data tool:

{
  "campaign_id": 12345,
  "download_type": "analytics", // "analytics", "leads", "sequence", "full_export"
  "format": "json", // "json" or "csv"
  "user_id": "optional-user-identifier"
}

View Download Statistics

View download statistics using the smartlead_view_download_statistics tool:

{
  "time_period": "all", // "all", "today", "week", "month"
  "group_by": "type" // "type", "format", "campaign", "date"
}

All downloads are tracked in ~/.smartlead-mcp/downloads.json for analytics.

Need Help?

• Run npx smartlead-mcp-server config to set up credentials