Smartlead MCP Server Local

🚀 Smartlead Simplified MCP Server

This application offers a simplified interface to access the Smartlead API, enabling AI assistants and automation tools to interact with Smartlead's email marketing features. Community contributions are welcome.

🚀 Quick Start

📦 Installation

You can install the package using npm:

npm install smartlead-mcp-server@1.2.1

Or use it directly with npx without installation:

⚠️ Important Note

For Claude:

npx smartlead-mcp-server start

For n8n:

npx smartlead-mcp-server sse

When you run it for the first time, you'll be prompted to enter your Smartlead API key. No license key is required.

💻 Usage Examples

Basic Usage

Here are the integration examples for different tools:

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 the n8n MCP client node with the following settings:
   • SSE URL: http://localhost:3000/sse
   • Message URL: http://localhost:3000/message

✨ Features

All features are now enabled by default, including but not limited to:

• Campaign and lead management
• Statistical analysis
• Smart delivery and webhooks
• n8n integration
• Customer management
• Smart sender
• Download tracking and analysis

🆕 New Download Tracking Feature

This version introduces the following download tracking features:

Download Campaign Data

Use the smartlead_download_campaign_data tool to download campaign data:

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

View Download Statistics

Use the smartlead_view_download_statistics tool to view download statistics:

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

All downloaded data will be saved in ~/.smartlead-mcp/downloads.json for analysis.

🤔 Need Help?

• Run npx smartlead-mcp-server config to set your credentials.
• Use the --api-key option for non-interactive setup.
• Contact: jonathan@jeantechnologies.com
• Website: jeantechnologies.com

📄 License

This software is proprietary and confidential. It may not be reproduced, distributed, or used in any form without the explicit permission of Jean Technologies.

Copyright © 2025 Jean Technologies. All rights reserved.